Phone-Book Operation
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
Entries in the Remote Access Service phone book contain the data necessary to establish a RAS connection. Unlike Windows-based desktop operating systems, which keep phone-book entries in a file, Windows Embedded CE stores these entries in the registry.
To make a connection without using a phone-book entry, RasDial can specify an empty string for the szEntryName member of the RASDIALPARAMS structure. The szPhoneNumber member must contain the phone number to dial.
RAS phone-book data includes:
- The phone number to dial, including country/region code and area code.
- The IP addresses to use while the connection is active.
- The network protocols.
- The type of device used to make the connection.
Windows Embedded CE supports a limited set of Window-based desktop functions for working with phone-book entries. The application can use the RasGetEntryProperties or RasSetEntryProperties function to create or edit a phone-book entry. The application can use the RasGetEntryDialParams and RasSetEntryDialParams functions to set or retrieve the connection parameters for a phone-book entry. The RasEnumEntries function lists all the phone-book entry names using the RASENTRY structure.
Data for the RAS phone book is stored in the registry under the HKEY_CURRENT_USER\Comm\RasBook key. See RAS Registry Settings for details.
See Also
Concepts
Creating or Changing a Phone-Book Entry
Changing an Existing Phone-Book Entry
Enumerating Phone-Book Entries
Copying a Phone-Book Entry
Deleting a Phone-Book Entry