[New - Windows NT]
RASENTRY结构描述了电话簿条目。RasSetEntryProperties和RasGetEntryProperties函数使用此结构来设置和检索电话簿条目的属性。
typedef struct tagRASENTRY {en
DWORD dwSize;
DWORD dwfOptions;
//
//位置/电话号码。
//
DWORD dwCountryID;
DWORD dwCountryCode;
TCHAR szAreaCode[ RAS_MaxAreaCode + 1 ];
TCHAR szLocalPhoneNumber[ RAS_MaxPhoneNumber + 1 ];
DWORD dwAlternateOffset;
//
// Framing
//
RASIPADDR ipaddr;
RASIPADDR ipaddrDns;
RASIPADDR ipaddrDnsAlt;
RASIPADDR ipaddrWins;
RASIPADDR ipaddrWinsAlt;
//
//框架
//
DWORD dwFrameSize;
DWORD dwfNetProtocols;
DWORD dwFramingProtocol;
//
//脚本
//
TCHAR szScript[ MAX_PATH ];
//
//自动拨号
//
TCHAR szAutodialDll[ MAX_PATH ];
TCHAR szAutodialFunc[ MAX_PATH ];
//
//设备
//
TCHAR szDeviceType[ RAS_MaxDeviceType + 1 ];
TCHAR szDeviceName[ RAS_MaxDeviceName + 1 ];
//
// X.25
//
TCHAR szX25PadType[ RAS_MaxPadType + 1 ];
TCHAR szX25Address[ RAS_MaxX25Address + 1 ];
TCHAR szX25Facilities[ RAS_MaxFacilities + 1 ];
TCHAR szX25UserData[ RAS_MaxUserData + 1 ];
DWORD dwChannels;
//
//保留
//
DWORD dwReserved1;
DWORD dwReserved2;
#if (WINVER >= 0x401)
//
// Idle timeout
//
DWORD dwSubEntries;
DWORD dwDialMode;
DWORD dwDialExtraPercent;
DWORD dwDialExtraSampleSeconds;
DWORD dwHangUpExtraPercent;
DWORD dwHangUpExtraSampleSeconds;
//
// 空闲超时
//
DWORD dwIdleDisconnectSeconds;
#万一
} RASENTRY;
会员
的dwSize
指定RASENTRY结构的大小(以字节为单位)。在致电RasSetEntryProperties或RasGetEntryProperties之前,将的dwSize设置为sizeof(RASENTRY)以标识结构的版本。
INT TabCtrl_GetItemCount(
一组指定连接选项的位标志。您可以设置一个或多个以下标志。
旗 | 描述 |
RASEO_UseCountryAndAreaCodes | 如果设置此标志,则dwCountryID,dwCountryCode和szAreaCode成员用于构建电话号码。如果未设置此标志,这些成员将被忽略。 该标志对应于电话对话框中的使用国家和地区代码复选框。 |
RASEO_SpecificIpAddr | 如果设置此标志,RAS将尝试使用IPADDR指定的IP地址作为拨号连接的IP地址。如果此标志未设置,则IPADDR成员的值将被忽略。 设置RASEO_SpecificIpAddr标志对应于在“TCP / IP设置”对话框中选择“指定IP地址”设置。清除RASEO_SpecificIpAddr标志对应于在TCP / IP设置对话框中选择服务器分配的IP地址设置。 目前,电话簿条目属性中设置的IP地址或从服务器检索的IP地址将覆盖网络控制面板中设置的IP地址。 |
RASEO_SpecificNameServers | 如果设置此标志,RAS将使用ipaddrDns,ipaddrDnsAlt,ipaddrWins和ipaddrWinsAlt成员来指定拨号连接的名称服务器地址。如果未设置此标志,RAS将忽略这些成员。 设置RASEO_SpecificNameServers标志对应于在“TCP / IP设置”对话框中选择“指定名称服务器地址”设置。清除RASEO_SpecificNameServers标志对应于在“TCP / IP设置”对话框中选择“服务器分配名称服务器地址”设置。 |
RASEO_IpHeaderCompression | 如果设置此标志,则RAS协商在PPP连接上使用IP头压缩。 如果未设置此标志,则不会协商IP报头压缩。 此标志对应于TCP / IP设置对话框中的使用IP头压缩复选框。通常建议设置此标志,因为IP头压缩显着提高性能。只有连接到无法正确协商IP报头压缩的服务器时,才应清除该标志。 |
RASEO_RemoteDefaultGateway | 如果设置了此标志,则当连接处于活动状态时,IP数据包的默认路由是通过拨号适配器。如果该标志清除,则不修改默认路由。 此标志对应于TCP / IP设置对话框中的远程网络上的使用默认网关复选框。 |
RASEO_DisableLcpExtensions | 如果设置此标志,RAS将禁用RFC 1570中定义的PPP LCP扩展。这可能需要连接到某些较旧的PPP实现,但会干扰诸如服务器回调等功能。除非特别要求,否则不要设置此标志。 |
RASEO_TerminalBeforeDial | 如果设置了此标志,RAS会在拨号连接前显示用户输入的终端窗口。 |
RASEO_TerminalAfterDial | 如果设置此标志,RAS将在拨号连接后显示用户输入的终端窗口。 如果拨号网络脚本与连接相关联,则不要设置此标志,因为脚本具有自己的终端实现。 |
RASEO_ModemLights | 此标志当前被忽略。 |
RASEO_SwCompression | 如果设置了该标志,则在链路上协商软件压缩。设置此标志会导致PPP驱动程序尝试与服务器协商CCP。该标志应该默认设置,但如果服务器不支持兼容的压缩协议,则清除该标志可以减少协商周期。 |
RASEO_RequireEncryptedPw | 如果设置此标志,则只能使用安全密码方案来验证与服务器的客户端。这样可以防止PPP驱动程序使用PAP明文认证协议对客户端进行认证。还支持CHAP和SPAP认证协议。清除此标志以提高互操作性,并设置其增强的安全性。 此标志对应于“安全”对话框中的“需要加密密码”复选框。另请参见RASEO_RequireMsEncryptedPw。 |
RASEO_RequireMsEncryptedPw | 如果设置此标志,则只能使用Microsoft的安全密码方案来验证客户端与服务器。这样可以防止PPP驱动程序使用PPP明文认证协议MD5-CHAP,MS-CHAP或SPAP。应该清除标志以实现最大的互操作性,并应设置为最大的安全性。此标志优先于RASEO_RequireEncryptedPw。 此标志对应于“安全性”对话框中的“需要Microsoft加密密码”复选框。另请参见RASEO_RequireDataEncryption。 |
RASEO_RequireDataEncryption | 如果设置此标志,则必须成功协商数据加密,或者删除连接。除非RASEO_RequireMsEncryptedPw也被设置,否则该标志被忽略。 此标志对应于“安全”对话框中的“需要数据加密”复选框。 |
RASEO_NetworkLogon | 如果设置了此标志,RAS将在点对点连接建立后登录网络。 此标志当前在Windows NT下无效。 |
RASEO_UseLogonCredentials | 如果设置此标志,RAS会在拨打此条目时使用当前登录用户的用户名,密码和域。除非RASEO_RequireMsEncryptedPw也被设置,否则该标志被忽略。 请注意,RasDial功能会忽略此设置,其中为RASDIALPARAMS结构的szUserName和szPassword成员指定空字符串会产生相同的结果。 此标志对应于“安全”对话框中的“使用当前用户名和密码”复选框。 |
RASEO_PromoteAlternates | 当备用电话号码由dwAlternateOffset成员定义时,此标志有效果。如果设置此标志,则连接成功的备用电话号码将成为主电话号码,并将当前主电话号码移动到备用列表。 此标志对应于“备用数字”对话框中的复选框。 |
RASEO_SecureLocalFiles | 仅Windows NT:如果设置了此标志,RAS将在与此条目建立连接之前检查现有远程文件系统和远程打印机绑定。通常,您将此标志设置为公共网络的电话簿条目,以提醒用户在连接到公共网络之前断开与其私有网络的连接。 |
dwCountryID
指定TAPI国家/地区标识符。使用RasGetCountryInfo功能枚举国家标识符。除非INT TabCtrl_GetItemCount(成员指定RASEO_UseCountryAndAreaCodes标志,否则此成员将被忽略。
dwCountryCode
指定电话号码的国家代码部分。国家代码必须与dwCountryID指定的国家/地区标识对应。如果dwCountryCode为零,则国家/地区代码基于dwCountryID指定的国家/地区标识。除非INT TabCtrl_GetItemCount(指定RASEO_UseCountryAndAreaCodes标志,否则此成员将被忽略。
szAreaCode
将区域代码指定为空终止的字符串。如果拨号位置没有区号,请指定一个空字符串(“”)。区域代码字符串中不要包括括号或其他分隔符。(例如,“206”是有效的区号,“(206)”不是。除非INT TabCtrl_GetItemCount(成员指定RASEO_UseCountryAndAreaCodes标志,否则此成员将被忽略。
szLocalPhoneNumber
指定一个包含电话号码的以空字符结尾的字符串。RAS使用此字符串的方式取决于INT TabCtrl_GetItemCount(成员是否指定RASEO_UseCountryAndAreaCodes标志。如果标志设置,RAS将szLocalPhoneNumber,dwCountryCode和szAreaCode成员指定的国家/地区代码与szLocalPhoneNumber组合。如果标志未设置,RAS将使用szLocalPhoneNumber字符串作为整个电话号码。
dwAlternateOffset
指定从结构的开始到连续的以null结尾的字符串的列表的偏移量(以字节为单位)。最后一个字符串由两个连续的空字符终止。如果主号码(见szLocalPhoneNumber)无法连接,则字符串是RAS以列出的顺序拨号的备用电话号码。备用电话号码字符串是ANSI或Unicode,具体取决于您是使用ANSI或Unicode版本的结构。
IPADDR
指定此连接处于活动状态时要使用的IP地址。除非INT TabCtrl_GetItemCount(指定RASEO_SpecificIpAddr标志,否则此成员将被忽略。
Specifies the IP address of the DNS server to be used while this connection is active.
指定此连接处于活动状态时要使用的DNS服务器的IP地址。除非INT TabCtrl_GetItemCount(指定RASEO_SpecificNameServers标志,否则此成员将被忽略。
ipaddrDnsAlt
指定在此连接处于活动状态时要使用的辅助或备份DNS服务器的IP地址。除非INT TabCtrl_GetItemCount(指定RASEO_SpecificNameServers标志,否则此成员将被忽略。
Specifies the network protocol frame size.
指定在此连接处于活动状态时要使用的WINS服务器的IP地址。除非INT TabCtrl_GetItemCount(指定RASEO_SpecificNameServers标志,否则此成员将被忽略。
ipaddrWinsAlt
指定在此连接处于活动状态时要使用的辅助WINS服务器的IP地址。除非INT TabCtrl_GetItemCount(指定RASEO_SpecificNameServers标志,否则此成员将被忽略。
dwFrameSize
指定网络协议帧大小。该值应为1006或1500。除非dwFramingProtocol指定RASFP_Slip标志,否则此成员将被忽略。
dwfNetProtocols
指定要协商的网络协议。该成员可以是以下标志的组合。
旗 | 描述 |
RASNP_Netbeui | 协商NetBEUI协议。 |
RASNP_Ipx | 协商IPX协议。 |
RASNP_Ip | 协商TCP / IP协议。 |
dwFramingProtocol
指定服务器使用的成帧协议。PPP是新兴的标准。SLIP主要用于UNIX环境。该成员可以是以下标志之一。
旗 | 描述 |
RASFP_Ppp | 点到点协议(PPP) |
RASFP_Slip | 串行互联网协议(SLIP) |
RASFP_Ras | 在Windows NT 3.1和Windows for Workgroups 3.11中实现的Microsoft专有协议 |
要使用压缩SLIP,请设置RASFP_Slip标志,并在INT TabCtrl_GetItemCount(成员中设置RASEO_IpHeaderCompression标志。
Specifies a null-terminated string containing the name of the script file.
指定一个以空字符结尾的字符串,其中包含脚本文件的名称。文件名应该是一个完整的路径。
Windows NT:要指示Windows NT SWITCH.INF脚本名称,请将名称的第一个字符设置为“[”。
szAutodialDll
指定一个以null结尾的字符串,其中包含自定义AutoDial处理程序的动态链接库(DLL)的完整路径和文件名。如果szAutodialDll包含空字符串(“”),则RAS使用默认拨号用户界面,并忽略szAutodialFunc成员。
szAutodialFunc
指定一个空值终止的字符串,其中包含自定义AutoDial处理程序的RASADFunc函数的导出名称。AutoDial DLL必须提供RASADFunc处理程序的ANSI和Unicode版本。但是,请勿在szAutodialFunc指定的名称中加上“A”或“W”后缀。
szDeviceType
指定由szDeviceName引用的RAS设备类型的以null结尾的字符串。该成员可以是以下字符串常量之一。
串 | 描述 |
RASDT_Modem | 通过COM端口访问调制解调器。 |
RASDT_Isdn | 安装了相应的NDISWAN驱动程序的ISDN卡。 |
RASDT_X25 | 安装了相应的NDISWAN驱动程序的X.25卡。 |
szDeviceName
包含一个以null结尾的字符串,其中包含要用于此电话簿条目的TAPI设备的名称。要枚举所有可用的具有RAS能力的设备,请使用RasEnumDevices功能。
szX25PadType
包含用于标识X.25 PAD类型的以null结尾的字符串。将此成员设置为“”,除非条目应使用X.25 PAD拨号。
Windows NT:在Windows NT下,szX25PadType字符串映射到PAD.INF中的段名称。
szX25Address
包含一个以空字符结尾的字符串,用于标识要连接的X.25地址。将此成员设置为“”,除非条目应使用X.25 PAD或本地X.25设备拨号。
szX25Facilities
包含一个空值终止的字符串,用于指定在连接时从X.25主机请求的工具。如果szX25Address为空字符串(“”),则会忽略此成员。
szX25UserData
包含一个空值终止的字符串,用于指定在连接时提供给X.25主机的附加连接信息。如果szX25Address为空字符串(“”),则忽略该成员。
Specifies the number of multilink subentries associated with this entry.;
DWORD EnumPrinterData(
Reserved; must be zero.
DWORD EnumPrinterData(
Reserved; must be zero.
dwSubEntries
指定与此条目关联的多链接子条目数。调用RasSetEntryProperties时,将此成员设置为零。要将子条目添加到电话簿条目,请使用RasSetSubEntryProperties功能。
dwDialMode
指示当该条目首次连接时RAS是否应拨打所有此条目的多链接子条目。该成员可以是以下值之一。
值 | 含义 |
RASEDM_DialAll | 最初拨打所有子条目。 |
RASEDM_DialAsNeeded | 调整子条数,因为需要带宽。RAS使用dwDialExtraPercent,dwDialExtraSampleSeconds,dwDialHangUpExtraPercent,和dwHangUpExtraSampleSeconds成员确定何时拨号或断开子条目。 |
dwDialExtraPercent
指定当前连接的子条目可用的总带宽的百分比。当所使用的总带宽超过dwDialExtraSampleSeconds秒的可用带宽的dwDialExtraPercent百分比时,RAS拨打额外的子条目。
除非dwDialMode成员指定RASEDM_DialAsNeeded标志,否则此成员将被忽略。
dwDialExtraSampleSeconds
指定RAS拨打其他子条目之前,当前带宽使用率必须超过dwDialExtraPercent指定的阈值的秒数。
除非dwDialMode成员指定RASEDM_DialAsNeeded标志,否则该成员将被忽略。
dwHangUpExtraPercent
指定当前连接的子条目可用的总带宽的百分比。当所使用的总带宽至少为dwHangUpExtraSampleSeconds秒时,可用带宽的百分比小于dwHangUpExtraPercent,RAS终止(挂起)现有的子条目连接。
除非dwDialMode成员指定RASEDM_DialAsNeeded标志,否则此成员将被忽略。
dwHangUpExtraSampleSeconds
指定RAS终止现有子条目连接前当前带宽使用率必须小于dwHangUpExtraPercent指定的阈值的秒数。
除非dwDialMode成员指定RASEDM_DialAsNeeded标志,否则该成员将被忽略。
dwIdleDisconnectSeconds
指定连接由于不活动而终止的秒数。请注意,除非空闲超时被禁用,如果连接在指定的时间间隔空闲,整个连接将被终止。该成员可以指定秒数或以下值之一。
值 | 含义 |
RASIDS_Disabled | 此连接没有空闲超时。 |
RASIDS_UseGlobalValue | 使用用户首选项作为默认值。 |
也可以看看
RASADFunc, RasGetCountryInfo, RasSetEntryProperties, RasSetSubEntryProperties