Microsoft KB Archive/140405

Win32 RAS API Extensions for Phonebook Manipulation

PSS ID Number: Q140405 Article last modified on 01-15-1996

95 3.50 3.51

WINDOWS

= SUMMARY =

This article describes the proposed API for creating and editing phone book entries for Windows 95 and Windows NT Dial Up Networking. This API is preliminary and subject to change.

= MORE INFORMATION =

The existing Win32 RAS API does not provide a means for programmatically manipulating the properties of a phone book entry. The existing API, exported by RASAPI32.DLL, does however include several functions which can be used to manipulate phone book entries:

 == RasCreatePhonebookEntry ==

The RasCreatePhonebookEntry function creates a new phonebook entry. The function displays a dialog box in which the user types information about the phonebook entry.  == RasEditPhonebookEntry ==

The RasEditPhonebookEntry function edits an existing phonebook entry. The function displays a dialog box in which the user can modify the existing information.  == RasEnumEntries ==

The RasEnumEntries function lists all entry names in a remote access phonebook.  == RasGetEntryDialParams ==

The RasGetEntryDialParams function retrieves the connection information saved by the last successful call to the RasDial or RasSetEntryDialParams function for a specified phonebook entry.  == RasSetEntryDialParams ==

The RasSetEntryDialParams function changes the connection information saved by the last successful call to the RasDial or RasSetEntryDialParams function for a specified phonebook entry. Only the username, password, domain name and callback number can be altered via this interface. 

The API extensions consist of seven additional interfaces to be exported from RASAPI32.DLL.

 == RasValidateEntryName ==

The RasValidateEntryName function validates that a proposed entry name is not a duplicate and is composed of legal characters.  == RasSetEntryProperties ==

The RasSetEntryProperties functions changes the properties of a specified phonebook entry. This function can also be used to create a new phonebook entry. </li> == RasGetEntryProperties ==

The RasGetEntryProperties function retrieves the properties of a specified phonebook entry including negotiable protocols and TCP/IP settings. </li> == RasRenameEntry ==

The RasRenameEntry function renames an existing phonebook entry. </li> == RasDeleteEntry ==

The RasDeleteEntry function deletes an existing phonebook entry. </li> == RasGetCountryInfo ==

The RasGetCountryInfo function retrieves the telephony information for a specific country ID. This interface can be used to retrieve country information without having to write a TAPI application. </li> == RasEnumDevices ==

The RasEnumDevices function retrieves the names of all the RAS capable TAPI devices in the system. </li></ul>

These APIs are also exported by a redistributable add-on DLL for Windows 95 called RNAPH.DLL so that third parties can make use of the APIs with the released version of RASAPI32.DLL. The APIs exported from RNAPH.DLL are identical to the proposed RASAPI32.DLL APIs. Since RNAPH.DLL will not be distributed once the APIs are incorporated into RASAPI32.DLL, the recommended method for using these APIs is to dynamically link to the APIs in RASAPI32.DLL using LoadLibrary and GetProcAddress. If the APIs are not available in RASAPI32.DLL then the application should dynamically link to RNAPH.DLL. Failure to follow this procedure may result in problems for your application when customers upgrade their Windows 95 system.

The compressed ZIP file containing the RNAPH.DLL and RNAPH.H file can be found on the internet at the following address:

http://198.105.232.5/DEVONLY/STRATEGY/WIN32/RASAPI.HTM

The file name is:

RAS1244B.ZIP

KBCategory: kbprg KBSubcategory: ntras nt32ap Additional reference words: prodnt 95 3.50 3.51 ============================================================================= Copyright Microsoft Corporation 1996.