Win32 RAS API Extensions for Phonebook Manipulation
  
PSS ID Number: Q140405
Article last modified on 01-15-1996
 
95 3.50 3.51
 
WINDOWS
 

------------------------------------------------------------
The information in this article applies to:
 
 - Microsoft Windows NT Workstation versions 3.5 and 3.51
 - Microsoft Windows NT Server versions 3.5 and 3.51
 - Microsoft Windows 95
------------------------------------------------------------
 
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.
 
 - RasGetEntryProperties
   ---------------------
 
   The RasGetEntryProperties function retrieves the properties of a
   specified phonebook entry including negotiable protocols and TCP/IP
   settings.
 
 - RasRenameEntry
   --------------
 
   The RasRenameEntry function renames an existing phonebook entry.
 
 - RasDeleteEntry
   --------------
 
   The RasDeleteEntry function deletes an existing phonebook entry.
 
 - 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.
 
 - RasEnumDevices
   --------------
 
   The RasEnumDevices function retrieves the names of all the RAS capable
   TAPI devices in the system.
 
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.
