Share via

Phone-Book Operation

  • Article

Entries in the Remote Access Service phone book contain the data necessary to establish a RAS connection. Unlike Windows-based desktop platforms, which keep phone-book entries in a file, Windows 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 CE supports a limited set of Window-based desktop platform 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.

The configuration file, which contains data for the RAS phone book, is stored in the registry under the HKEY_CURRENT_USER\Comm\RasBook key. Entry names for Windows CE must be legal registry keys and cannot exceed 20 characters.

See Also

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 | Dial-up Networking

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.