RASDIALPARAMS (Windows CE 5.0)
This structure contains parameters used by the RasDial function to establish a remote access connection.
typedef struct _RASDIALPARAMS { 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 ]; } RASDIALPARAMS;
Members
- dwSize
Specifies the structure size, in bytes. - szEntryName
Null-terminated string that contains the phone-book entry to use to establish the connection. This member cannot be NULL. - szPhoneNumber
This parameter is ignored and should be set to NULL. - szCallbackNumber
This parameter is ignored and should be set to NULL. - szUserName
Null-terminated string that contains the user's user name. This string is used to authenticate the user's access to the remote access server. - szPassword
Null-terminated string that contains the user's password. This string is used to authenticate the user's access to the remote access server. - szDomain
Null-terminated string that contains the domain on which authentication is to occur. An empty string ("") specifies the domain in which the remote access server is a member. An asterisk specifies the domain stored in the phone book for the entry.
Remarks
The szCallbackNumber and szPhoneNumber members are ignored and should always be set to NULL.
The szUserName and szPassword strings are used to authenticate the user's access to the remote access server.
When retrieving the password using the RasGetEntryDialParams function in Windows CE 3.0 or later, the szPassword member does not receive the actual password. Instead, szPassword receives a handle to the saved password. Substitute this handle for the saved password in calls to RasSetEntryDialParams, and RasDial. When presented with this handle, RasDial retrieves and uses the saved password. The value of this handle may change in future versions of the operating system; do not develop code that depends on the contents or format of this value.
Requirements
OS Versions: Windows CE 1.0 and later.
Header: Ras.h.
See Also
RasDial | RasSetEntryDialParams | RasGetEntryDialParams
Send Feedback on this topic to the authors