Share via


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