rasentry.txt

1.wince下判断拨号连接状态.以及设置拨号参数.

//
// Copyright (c) Microsoft Corporation.  All rights reserved.
//
//
// Use of this source code is subject to the terms of the Microsoft end-user
// license agreement (EULA) under which you licensed this SOFTWARE PRODUCT.
// If you did not accept the terms of the EULA, you are not authorized to use
// this source code. For a copy of the EULA, please see the LICENSE.RTF on your
// install media.
//

RasEntry -  RAS Connection Creation Program


This program adds an entry to the default RAS phonebook from
information stored in a configuration file.  (The RAS phonebook is
kept in the registry under Windows CE.)  The command line is in the
form RasEntry [verbosity] filename, where "verbosity" is the log
output verbosity (see below) and "filename" is the pathname to the
configuration file.  If the pathname contains spaces it should be
enclosed in quotes as shown.

Examples:
   RasEntry  "\My Documents\microsoft.ras"
   RasEntry  -d15 serial.ras

 "RasEntry" configuration files (by convention "*.ras") are text
files consisting of a series of lines in the form "Label=Value".
Only the "Name" field is required, although several other fields are
normally included; any fields not included are set to the default
values for the device.  The parser is fairly simple and will catch
some errors but might easily accept bogus data.  Be careful with
trailing spaces (especially for user names and passwords).  Supported
fields include:

Name                    String      Connectoid name (such as "Serial Connection")
CountryCode             Numeric     Country/Region code for dialing ("1" = USA)
AreaCode                String      Telephone area code
Phone                   String      Local telephone number
SpecificIpAddr          Boolean     If "Y", use specified "IpAddr"
IpAddr                  IpAddr      Dotted-decimal format (xxx.xxx.xxx.xxx)
SpecificNameServers     Boolean     If "Y", use specified "DnsAddr" and "WinsAddr"
DnsAddr                 IpAddr      Dotted-decimal format
AltDnsAddr              IpAddr      Dotted-decimal format
WinsAddr                IpAddr      Dotted-decimal format
AltWinsAddr             IpAddr      Dotted-decimal format
DeviceType              String      Connection type ("modem" or "direct")
DeviceName              String      Friendly name of device (see below)
IpHeaderCompression     Boolean     If "Y", negotiate IP header compression
SwCompression           Boolean     If "Y", negotiate software compression
UseCountryAndAreaCodes  Boolean     If "Y", dial call as long-distance
RequireEncryptedPw      Boolean     If "Y", require password encryption
RequireMsEncryptedPw    Boolean     If "Y", require Microsoft password encryption
RequireDataEncryption   Boolean     If "Y", require data encryption
DialAsLocalCall         Boolean     If "Y", use local call dialing pattern when area code differs
Framing                 Char        "S" or "s" for SLIP; default is PPP
FrameSize               Numeric     SLIP frame size (1006 or 1500)
Script                  String      Script file
UserName                String
Password                String
Domain                  String
BaudRate                Numeric     Serial port baud rate
                                    (only for unimodem devices)


Name - This field contains the name of the new entry and is required.
Entry names for Windows CE must be legal registry keys and cannot
exceed 20 characters.

Device Name - The user-friendly name of the device used for the RAS
connection; it should normally be specified. Commonly available
devices on CE devices include "Hayes Compatible on COM1:" (standard
external modem), "Infrared Port", and "Serial Cable on COM1:"; PCMCIA
modem names are unique names assigned by the card manufacturer.

Output from "RasEntry" is logged to the debug port on a CE device or
to the console window when using NT.  The verbosity level of the
debug output may be specified using the optional command-line flag
-d<verbosity>.  Verbosity levels range from 0 (least verbose) to 15
(most verbose); the default verbosity is 10.

If "RasEntry" is called without any command-line parameters, a list
of the entries currently on the device will be sent to the debug
output.

Some sample configuration files are listed below. 

Name=Microsoft RAS
UseCountryAndAreaCodes=N
CountryCode=1
AreaCode=425
Phone=555-1212
SpecificIpAddr=N
SpecificNameServers=N
DeviceType=modem
DeviceName=Hayes Compatible on COM1:
SwCompression=N
IpHeaderCompression=N
UserName=myname
Password=mypassword
Domain=MYDOMAIN


Name=Serial Connection
UseCountryAndAreaCodes=N
SpecificIpAddr=N
SpecificNameServers=N
DeviceType=direct
DeviceName=Serial Cable on COM1:
IpHeaderCompression=N
SwCompression=N
UserName=myname
Password=mypassword