please dont rip this site Prev Next

RASDIALPARAMS info  Overview  Group

The RASDIALPARAMS structure contains parameters used by RasDial 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] ; 

#if (WINVER >= 0x401)

   DWORD  dwSubEntry;

   DWORD  dwCallbackId;





Specifies the structure size, in bytes.
Specifies a string containing 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.
Specifies a string containing an overriding phone number. An empty string (““) indicates that the phone-book entry’s phone number should be used. If szEntryName is ““, szPhoneNumber cannot be ““.
Specifies a string containing a callback phone number. An empty string (““) indicates that callback should not be used. This string is ignored unless the user has “Set By Caller” callback permission on the RAS server. An asterisk indicates that the number stored in the phone book should be used for callback.
Specifies a string containing the user’s user name. This string is used to authenticate the user’s access to the remote access server.
Specifies a string containing the user’s password. This string is used to authenticate the user’s access to the remote access server.

Windows NT: You can use szPassword to send a new password to the remote server when you restart a RasDial connection from a RASCS_PasswordExpired paused state. When changing a password on an entry that calls Microsoft Networks, you should limit the new password to 14 characters in length to avoid down-level compatibility problems.

Specifies a string containing 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.
Specifies the index of the initial subentry to dial. If the phone-book entry has no subentries or the dial mode of the phone-book entry is RASEDM_DialAll, dwSubEntry is ignored. If the dial mode is RASEDM_DialAsNeeded, RAS dials the specified subentry. If dwSubEntry is not a valid subentry index, RAS dials the first subentry. The RASENTRY structure returned by RasGetEntryProperties indicates the dial mode and number of subentries for the phone-book entry.
Specifies an application-defined value that RAS passes to your RasDialFunc2 callback function.


The szUserName and szPassword strings are used to authenticate the user’s access to the remote access server.

Windows NT:
RAS does not actually log the user onto the network. The user does this in the usual manner, for example, by logging on with cached credentials prior to making the connection or by using CTRL+ALT+DEL, after the RAS connection is established.

If both the szUserName and szPassword members are empty strings (""), RAS uses the user name and password of the current logon context for authentication. For a user mode application, RAS uses the credentials of the currently logged-on interactive user. For a Win32 service process, RAS uses the credentials associated with the service.

Windows 95:
RAS uses the szUserName and szPassword strings to log the user onto the network. Windows 95 cannot get the password of the currently logged-on user, so if both the szUserName and the szPassword members are empty strings (““), RAS leaves the user name and password empty during authentication.

See Also


file: /Techref/os/win/api/win32/struc/src/str15_5.htm, 5KB, , updated: 2000/4/7 12:20, local time: 2024/6/18 07:27,

 ©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions?
Please DO link to this page! Digg it! / MAKE!


After you find an appropriate page, you are invited to your to this massmind site! (posts will be visible only to you before review) Just type a nice message (short messages are blocked as spam) in the box and press the Post button. (HTML welcomed, but not the <A tag: Instead, use the link box to link to another page. A tutorial is available Members can login to post directly, become page editors, and be credited for their posts.

Link? Put it here: 
if you want a response, please enter your email address: 
Attn spammers: All posts are reviewed before being made visible to anyone other than the poster.
Did you find what you needed?

  PICList 2024 contributors:
o List host: MIT, Site host, Top posters @none found
- Page Editors: James Newton, David Cary, and YOU!
* Roman Black of Black Robotics donates from sales of Linistep stepper controller kits.
* Ashley Roll of Digital Nemesis donates from sales of RCL-1 RS232 to TTL converters.
* Monthly Subscribers: Gregg Rew. on-going support is MOST appreciated!
* Contributors: Richard Seriani, Sr.

Welcome to!