|
|
[ENTRY] -- Taken from the Dial Up entry name in Win9x
Type=<RASET-code> -- RASET codes are defined in ras.h. They are RASET_Phone (0x1) , RASET_Vpn (0x2), RASET_Direct (0x3), RASET_Internet (0x4). This setting determines what is dialup options are presented to the end user.
Description=<description> -- This is not used by NT5 and nothing is migrated to it.
AutoLogon=<1/0> -- ???????????????
DialParamsUID=<unique-ID> -- ???????????????
Guid=<guid> -- Nothing is migrated to this setting. A GUID will be assigned to the entry the first time it is used on NT 5.0.
UsePwForNetwork=<1/0> -- This is unused on NT 5.0 and nothing is migrated to it.
ServerType=<ST-code> -- This is unused on NT 5.0 and nothing is migrated to it.
BaseProtocol=<BP-code> ;same Authentication=<AS-code> ;same ExcludedProtocols=<NP-bits> ;same LcpExtensions=<1/0> ;same DataEncryption=<DE-code> ;same, but new codes for IpSec SkipNwcWarning=<1/0> ;same SkipDownLevelDialog=<1/0> ;same SwCompression=<1/0> ;same UseCountryAndAreaCodes=<1/0> ;Deleted, becomes "UseDRules" of 1st phone# AreaCode=<string> ;Deleted, becomes "AreaCode" of 1st phone# CountryID=<id> ;Deleted, becomes "CountryID" of 1st # CountryCode=<code> ;Deleted, becomes "CountryCode" of 1st #
ShowMonitorIconInTaskBar=<1/0> -- The answer to this is the value stored in !(<HKR\Remote Access\[DialUi]> & DIALUI_DONT_SHOW_ICON)
CustomAuthKey=<EAP-code> -- Nothing is migrated to this key from Windows9x.
CustomAuthData=<hexdump> -- Nothing is migrated to this key from Windows9x.
AuthRestrictions=<AR-code> -- Nothing is migrate to this key from Windows9x.
OverridePref=<RASOR-bits> -- Set to "15" on upgrade. This ensures that RedialAttempts, RedialSeconds, IdleDisconnectSeconds, and RedialOnLinkFailure are used from the entry. This is also the default set on NT 5.0.
DialMode=<DM-code> -- Nothing migrated currently for this setting. Need to have multilink tested further to see if there is something that can be put there (I do not think that there is..)
DialPercent=<0-100> -- Hardcoded to '90' during migration.
DialSeconds=<1-n> -- Hardcoded to '120' during migration.
HangUpPercent=<0-100> -- Hardcoded to '50' during migration.
HangUpSeconds=<1-n> -- Hardcoded to '120' during migration.
RedialAttempts=<n> -- <HKR\Remote Access\[RedialTry]>
RedialSeconds=<n> -- let d = <HKR\Remote Access\[RedialWait]>, then DialSeconds = HIWORD(d) * 60 + LOWORD(d)
IdleDisconnectSeconds=<-1,0-n> -- Hardcoded to '-1' during migration.
RedialOnLinkFailure=<1/0> -- Defaults to 0 during migration.
CallbackMode=<1/0> -- Defaults to 0 during migration.
CustomDialDll=<path> ;same, i.e. NYI CustomDialFunc=<func-name> ;same, i.e. NYI AuthenticateServer=<1/0> ;same
SecureLocalFiles=<1/0> -- Not used during migration. ShareMsFilePrint=<1/0> -- Not used during migration. BindMsNetClient=<1/0> -- Not used during migration (need to investigate.)
SharedPhoneNumbers=<1/0> ;New PrerequisiteEntry=<entry-name> ;New PreviewUserPw=<1/0> ;New PreviewDomain=<1/0> ;New PreviewPhoneNumber=<1/0> ;New ShowDialingProgress=<1/0> ;New
IpPrioritizeRemote=<1/0> ;same (PPP/SLIP only) IpHeaderCompression=<1/0> ;same (PPP/SLIP only) IpAddress=<a.b.c.d> ;same (PPP/SLIP only) IpAssign=<ASRC-code> ;same (PPP/SLIP only) IpDnsAddress=<a.b.c.d> ;same (PPP/SLIP only) IpDns2Address=<a.b.c.d> ;same (PPP/SLIP only) IpWinsAddress=<a.b.c.d> ;same (PPP/SLIP only) IpWins2Address=<a.b.c.d> ;same (PPP/SLIP only) IpNameAssign=<ASRC-code> ;same (PPP/SLIP only) IpFrameSize=<1006/1500> ;same (SLIP only)
In general each section contains subsections delimited by MEDIA=<something> and DEVICE=<something> lines. There can be any number of DEVICE subsections. There can be multiple MEDIA/DEVICE sets where the position of the set determines it's sub-entry index, the first being 1, the second 2, etc.
For serial media, the program currently expects 1 to 4 DEVICE subsections, representing a preconnect switch, modem, X.25 PAD, and postconnect switch. Following is a full entry:
MEDIA=serial ;same Port=<port-name> ;same Device=<device-name> ;same ConnectBps=<bps> ;same, for old MXS support only
DEVICE=switch ;same Type=<switchname or Terminal> ;Deleted, converted to 2 fields below Name=<switchname> ;New, name of switch or empty if none Terminal=<1/0> ;New, terminal is to run with/without above
DEVICE=modem ;same
PhoneNumber=<phonenumber1> ;same AreaCode=<area-code1> ;New CountryID=<id> ;New CountryCode=<country-code> ;New UseDialingRules=<1/0> ;New Comment=<arbitrary-text1> ;New, 'Description' from upgrade ... PhoneNumber=<phonenumber2> ;same AreaCode=<area-code1> ;New CountryID=<id> ;New CountryCode=<country-code> ;New UseDialingRules=<1/0> ;New Comment=<arbitrary-text2> ;New ... PhoneNumber=<phonenumberN> ;same AreaCode=<area-code1> ;New CountryID=<id> ;New CountryCode=<country-code> ;New UseDialingRules=<1/0> ;New Comment=<arbitrary-textn> ;New
LastSelectedPhone=<index> ;New PromoteAlternates=<1/0> ;same TryNextAlternateOnFail=<1/0> ;New
TapiBlob=<hexdump> ;same, i.e. #if 0'd out ManualDial=<1/0> ;For old MXS support only HwFlowControl=<1/0> ;For old MXS support only Protocol=<1/0> ;For old MXS support only Compression=<1/0> ;For old MXS support only
DEVICE=pad ;same X25Pad=<padtype> ;same X25Address=<X121address> ;same UserData=<userdata> ;same Facilities=<facilities> ;same
DEVICE=switch ;same Type=<switchname or Terminal> ;Deleted, converted to 2 fields below Name=<switchname> ;New, name/path of switch or empty if none Terminal=<1/0> ;New, terminal is to run with/without above
For ISDN media, the program expects exactly 1 DEVICE subsection. Note that ISDN is now identical to the "other" case.
MEDIA=isdn ;same Port=<port-name> ;same Device=<device-name> ;same
DEVICE=isdn ;same
PhoneNumber=<phonenumber1> ;same AreaCode=<area-code1> ;New CountryID=<id> ;New CountryCode=<country-code> ;New UseDialingRules=<1/0> ;New Comment=<arbitrary-text1> ;New, 'Description' from upgrade ... PhoneNumber=<phonenumber2> ;same AreaCode=<area-code1> ;New CountryID=<id> ;New CountryCode=<country-code> ;New UseDialingRules=<1/0> ;New Comment=<arbitrary-text2> ;New ... PhoneNumber=<phonenumberN> ;same AreaCode=<area-code1> ;New CountryID=<id> ;New CountryCode=<country-code> ;New UseDialingRules=<1/0> ;New Comment=<arbitrary-textn> ;New
LastSelectedPhone=<index> ;New PromoteAlternates=<1/0> ;same TryNextPhoneNumberOnFail=<1/0> ;New
LineType=<0/1/2> ;same Fallback=<1/0> ;same EnableCompression=<1/0> ;For old protocol only ChannelAggregation=<channels> ;For old protocol only
For X.25 media, the program expects exactly 1 DEVICE subsection.
MEDIA=x25 ;same Port=<port-name> ;same Device=<device-name> ;same
DEVICE=x25 ;same X25Address=<X121address> ;same UserData=<userdata> ;same Facilities=<facilities> ;same
For other media, the program expects exactly one DEVICE subsection with device name matching the media. "Other" media and devices are created for entries assigned to all non-serial medias including ISDN which now matches the rules for "other".
MEDIA=<media> ;same Port=<port-name> ;same Device=<device-name> ;same
DEVICE=<media> ;same
PhoneNumber=<phonenumber1> ;same AreaCode=<area-code1> ;New CountryID=<id> ;New CountryCode=<country-code> ;New UseDialingRules=<1/0> ;New Comment=<arbitrary-text1> ;New, 'Description' from upgrade ... PhoneNumber=<phonenumber2> ;same AreaCode=<area-code1> ;New CountryID=<id> ;New CountryCode=<country-code> ;New UseDialingRules=<1/0> ;New Comment=<arbitrary-text2> ;New ... PhoneNumber=<phonenumberN> ;same AreaCode=<area-code1> ;New CountryID=<id> ;New CountryCode=<country-code> ;New UseDialingRules=<1/0> ;New Comment=<arbitrary-textn> ;New
LastSelectedPhone=<index> ;New PromoteAlternates=<1/0> ;same TryNextPhoneNumberOnFail=<1/0> ;New
The phonebook also supports the concept of "custom" entries, i.e. entries that fit the MEDIA followed by DEVICE subsection rules but which do not include certain expected key fields. A custom entry is not editable with the UI, but may be chosen for connection. This gives us a story for new drivers added by 3rd parties or after release and not yet fully supported in the UI. (NOTE: Support for this may be dropped in RAS API)
|
