Phone-Book Files and Connection Data

A RasDial call must specify the data RAS requires to establish a connection. Typically, the RasDial call provides the connection data by specifying a phone-book entry. The connection data in a phone-book entry includes phone numbers, bits-per-second rate, user authentication data, and other connection data.

A client application uses RasDial function parameters to specify a phone-book file and an entry in that file. The lpszPhonebookPath parameter can specify the name of a phone-book file, or it can be NULL to indicate that the default phone-book file should be used. The lpRasDialParams parameter points to the RASDIALPARAMS structure that specifies the name of the phone-book entry to use.

To display a list of phone-book entries from which a user can select, a client application can call the RasEnumEntries function to enumerate the phone-book file entries.