RASDIALPARAMS

【勇芳软件工作室】汉化HomePreviousNext

RASDIALPARAMS结构包含RasDial用于建立远程访问连接的参数。

typedef struct _RASDIALPARAMS {en

DWORD dwSize;

TCHAR szEntryName[RAS_MaxEntryName + 1];

TCHAR szPhoneNumber[RAS_MaxPhoneNumber + 1];

TCHAR szCallbackNumber[RAS_MaxCallbackNumber + 1];

TCHAR szUserName[UNLEN + 1];

TCHAR szPassword[PWLEN + 1];

TCHAR szDomain[DNLEN + 1] ;

#if (WINVER >= 0x401)

DWORD dwSubEntry;

DWORD dwCallbackId;

#万一

} RASDIALPARAMS;

会员

的dwSize

指定结构大小(以字节为单位)。

szEntryName

指定一个包含用于建立连接的电话簿条目的字符串。一个空字符串(“”)在第一个可用的调制解调器端口上指定一个简单的调制解调器连接,在这种情况下必须提供非空的szPhoneNumber.

szPhoneNumber

指定包含覆盖电话号码的字符串。空字符串(“”)表示应该使用电话簿条目的电话号码。如果szEntryName为“”,则szPhoneNumber不能为“”。

szCallbackNumber

指定一个包含回叫电话号码的字符串。空字符串(“”)表示不应该使用回调。除非用户在RAS服务器上具有“Set By Caller”回调权限,否则此字符串将被忽略。星号表示电话簿中存储的号码应用于回调。

szUserName

指定一个包含用户用户名的字符串。该字符串用于验证用户对远程访问服务器的访问。

szPassword

指定一个包含用户密码的字符串。该字符串用于验证用户对远程访问服务器的访问。

Windows NT:从RASCS_PasswordExpired暂停状态重新启动RasDial连接时,可以使用szPassword向远程服务器发送新密码。在调用Microsoft Networks的条目上更改密码时,您应该将新密码的长度限制为14个字符,以避免下级兼容性问题。

szDomain

指定一个包含要发生身份验证的域的字符串。空字符串(“”)指定远程访问服务器所在的域。星号指定电话簿中存储的条目的域。

dwSubEntry

指定要拨打的初始子条目的索引。如果电话簿条目没有子条目或电话簿条目的拨号模式是RASEDM_DialAll,dwSubEntry将被忽略。如果拨号模式为RASEDM_DialAsNeeded,则RAS拨打指定的子条目。如果dwSubEntry不是有效的子条目索引,则RAS拨打第一个子条目。由RasGetEntryProperties返回的RASENTRY结构表示电话簿条目的拨号模式和子条目数。

dwCallbackId

指定RAS传递给您的RasDialFunc2回调函数的应用程序定义值。

备注

szUserNameszPassword字符串用于验证用户对远程访问服务器的访问。

Windows NT:

RAS实际上并没有将用户登录到网络上。用户以通常的方式执行此操作,例如,在建立连接之后,通过使用缓存的凭据登录,或在建立RAS连接后使用CTRL + ALT + DEL。

如果szUserNameszPassword成员都是空字符串(“”),则RAS使用当前登录上下文的用户名和密码进行身份验证。对于用户模式应用程序,RAS使用当前登录的交互式用户的凭据。对于Win32服务进程,RAS使用与服务关联的凭据。

Windows 95:

RAS使用szUserNameszPassword字符串将用户记录到网络上。Windows 95无法获取当前登录的用户的密码,所以如果szUserNameszPassword成员都是空字符串(“”),RAS会在身份验证期间将用户名和密码留空。

也可以看看

RasDial