PRB: RasGetEntryDialParams( ) Does Not Retrieve Phone Number (157765)


The information in this article applies to:

  • Microsoft Win32 Application Programming Interface (API), when used with:
    • Microsoft Windows NT Server 4.0
    • Microsoft Windows NT Workstation 4.0
    • Microsoft Windows 95
    • Microsoft Windows 98
    • the operating system: Microsoft Windows 2000
This article was previously published under Q157765

SUMMARY

The RasGetEntryDialParams( ) API, by design, is not intended to retrieve the phone number of a given phonebook entry from the phonebook file.

MORE INFORMATION

This confusion may arise because the RASDIALPARAMS structure is used in two different APIs: RasDial( ) and RasGetEntryDialParams( ). When the RASDIALPARAMS structure is used with the RasDial( ) API, the szPhoneNumber field is used to specify a phone number that can be dialed on the fly. This field does not contain the phone number associated with an entry in the phonebook when used with the RasGetEntryDialParams( ) or RasSetEntryDialParams( ) APIs.

To get the phone number for a given phonebook entry, the RasGetEntryProperties( ) API should be used. Similarly, to set the phone number for a given phonebook entry, the RasSetEntryProperties( ) API should be used. These APIs are specific to Windows 95 and Windows NT 4.0 only.

Early releases of Windows 95 may require an additional DLL that contains these new phonebook manipulation APIs. This DLL, RNAPH.DLL, may be downloaded from Microsoft's World Wide Web Site at http://www.microsoft.com.
Modification Type:MinorLast Reviewed:12/16/2004
Keywords:kbAPI kbnetwork kbprb KB157765
©2004 Microsoft Corporation. All rights reserved.