Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[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 |
|---|---|
|
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 |
Siehe auch
übersicht über Ras(Remote Access Service)