RasCreatePhonebookEntryA-Funktion (ras.h)

Artikel
11/20/2024

[Diese Funktion ist seit Windows Vista veraltet und seine Funktionalität wurde durch RasDialDlgersetzt. ]

Die RasCreatePhonebookEntry-Funktion erstellt einen neuen Telefonbucheintrag. Die Funktion zeigt ein Dialogfeld an, in dem der Benutzer Informationen für den Telefonbucheintrag eingibt.

Syntax

DWORD RasCreatePhonebookEntryA(
  [in] HWND   unnamedParam1,
  [in] LPCSTR unnamedParam2
);

Parameter

[in] unnamedParam1

Behandeln des übergeordneten Fensters des Dialogfelds.

[in] unnamedParam2

Zeigen Sie auf eine NULL--terminated-Zeichenfolge, die den vollständigen Pfad und Dateinamen einer PbK-Datei (Phone-Book) angibt. Wenn dieser Parameter NULL-ist, verwendet die Funktion die aktuelle Standarddatei des Telefonbuchs. Die Standardmäßige Telefonbuchdatei ist die vom Benutzer im Eigenschaftenblatt Benutzereinstellungen Eigenschaftenblatt des Dialogfelds DFÜ-Netzwerk ausgewählt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes oder ein Wert aus Routing- und Remotezugriffsfehlercodes oder Winerror.h.

Rückgabecode	Beschreibung
ERROR_CANNOT_OPEN_PHONEBOOK	Das Telefonbuch ist beschädigt oder fehlende Komponenten.

Bemerkungen

Wenn Sie RasDialDlgaufrufen, legen Sie jedes Element der RASDIALDLG- Struktur fest, die an lpInfo auf Null übergeben wird, außer:

dwSize = sizeof(RASDIALDLG)
hwndOwner = der hwnd Parameter oben
dwFlags- = RASEDFLAG_NewEntry

Anmerkung

Der ras.h-Header definiert RasCreatePhonebookEntry als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	ras.h
Library	Rasapi32.lib
DLL-	Rasapi32.dll