RasGetEntryDialParams( ) Does Not Retrieve Phone Number

The information in this article applies to:

• Microsoft Win32 Application Programming Interface (API) for Windows NT and Win95, version 4.00
• Microsoft Windows NT Server, version 4.0
• Microsoft Windows NT Workstation, version 4.0
• Microsoft Windows 95

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.