Index   Commented   Search   About

Overview
Group
Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
rasapi32.lib
Header File
ras.h
Unicode
WinNt
Platform Notes
None

RasCreatePhonebookEntry

The RasCreatePhonebookEntry function creates a new phone-book entry. The function displays a dialog box in which the user types information about the phone-book entry.

Windows NT: The RasCreatePhonebookEntry function calls the RasEntryDlg function. Applications written for Windows NT version 4.0 should use RasEntryDlg.

DWORD RasCreatePhonebookEntry(

HWND hwnd,
// handle to the parent window of the dialog box
LPTSTR lpszPhonebook
// pointer to the full path and filename of the phone-book file
);

Parameters

hwnd

Handle to the parent window of the dialog box.

lpszPhonebook

Windows NT: Pointer to a null-terminated string that specifies the full path and filename of a phone-book (.PBK) file. If this parameter is NULL, the function uses the current default phone-book file. The default phone-book file is the one selected by the user in the User Preferences property sheet of the Dial-Up Networking dialog box.

Windows 95: Dial-up networking stores phone-book entries in the registry rather than in a phone-book file.

Return Values

If the function succeeds, the return value is zero.

If the function fails, the return value is the following error code:

Value
Description
ERROR_CANNOT_OPEN_PHONEBOOK


The phone book is corrupted or missing components.

See Also

RasEditPhonebookEntry
, RasEntryDlg, RasGetEntryDialParams, RasSetEntryDialParams

Related Links

Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET

More Online Helps

Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages

Free Tech Secrets ;) Copyright © 2008 Free Tect Secrets ;) greatis just4fun network just4fun