RASDIALPARAMS

This structure contains parameters used by the RasDial function to establish a remote access connection.

At a Glance

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. An empty string (“”) specifies a simple modem connection on the first available modem port, in which case a nonempty szPhoneNumber must be provided.

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.

See Also

RasDial