RASDIALPARAMS

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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 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

See Also

Reference

RasDial
RasSetEntryDialParams
RasGetEntryDialParams