DOCERR: RasDial() with Username and Password as Empty Strings

Last reviewed: June 22, 1995
Article ID: Q130023

The information in this article applies to:

Microsoft Windows Software Development Kit (SDK) version 3.11

The documentation for the RasDial() function incorrectly states the possible values for the members of one of the parameters, the RASDIALPARAMS structure. The documentation states:

   If both the szUserName and the szPassword members are empty strings
   (""), Remote Access uses the username and password of the currently
   logged-on user for authentication.

This API explicitly requires the name and the password for a valid RAS account even if the account belongs to the currently logged-on user. Specifying empty strings for the username and password members of RASDIALPARAMS results in authentication failure.

NOTE: This is only a problem in 16-bit Windows. The Win32 version of the RasDial() function implements it as documented.

Additional reference words: win16
KBCategory: kbprg kbnetwork kbdocerr
KBSubcategory: NtwkRAS

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: June 22, 1995
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.