RASDIALPARAMS (Compact 2013)
3/26/2014
This structure contains parameters used by the RasDial function to establish a remote access connection.
Syntax
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, 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.
Requirements
Header |
ras.h |
See Also
Reference
RAS Structures
RasDial
RasSetEntryDialParams
RasGetEntryDialParams