|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| No
| Win32s
| No
| Import Library
| rasdlg.lib
| Header File
| rasdlg.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
RasEntryDlg
[New - Windows NT]
The RasEntryDlg function displays modal property sheets that allow a user to manipulate
phone-book entries. If editing or copying an existing phone-book entry, the function
displays a phone-book entry property sheet. The RasEntryDlg function returns when the user closes the property sheet.
BOOL RasEntryDlg(
LPTSTR lpszPhonebook,
| // pointer to the full path and filename of the phone-book file
| LPTSTR lpszEntry,
| // pointer to the name of the phone-book entry to edit, copy, or create
| LPRASENTRYDLG lpInfo
| // pointer to a structure that contains additional parameters
| );
|
|
Parameters
lpszPhonebook
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.
lpszEntry
Pointer to a null-terminated string that contains the name of the phone-book
entry to edit, copy, or create.
If you are editing or copying an entry, this parameter is the name of an
existing phone-book entry. If you are copying an entry, set the RASEDFLAG_CloneEntry
flag in the dwFlags member of the RASENTRYDLG structure.
If you are creating an entry, this parameter is a default new entry name that
the user can change. If this parameter is NULL, the function provides a default
name. If you are creating an entry, set the RASEDFLAG_NewEntry flag in the dwFlags member of the RASENTRYDLG structure.
lpInfo
Pointer to a RASENTRYDLG structure that contains additional input and output parameters. On input, the dwSize member of this structure must specify sizeof(RASENTRYDLG). Use the dwFlags member to indicate whether you are creating, editing, or copying an entry. If
an error occurs, the dwError member returns an error code; otherwise, it returns zero.
Return Values
If the user creates, copies, or edits a phone-book entry, the return value is
a nonzero value.
If an error occurs, or if the user cancels the operation, the return value is
zero. If an error occurs, the dwError member of the RASENTRYDLG structure returns a nonzero system error code or RAS error code.
Remarks
The RasCreatePhonebookEntry and RasEditPhonebookEntry functions call the RasEntryDlg function.
See Also
RasCreatePhonebookEntry, RasEditPhonebookEntry, RASENTRYDLG
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
TMS Scripter Studio Pro components for Delphi/C++Builder
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
|
