Knowledge Base

PRB: RasGetEntryDialParams( ) Does Not Retrieve Phone Number

Article ID: 157765

Article Last Modified on 11/21/2006


APPLIES TO


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.

Keywords: kbapi kbnetwork kbprb KB157765