RasEditPhonebookEntryA-Funktion (ras.h)

Artikel
11/20/2024

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

Die RasEditPhonebookEntry Funktion bearbeitet einen vorhandenen Telefonbucheintrag. Die Funktion zeigt ein Dialogfeld an, in dem der Benutzer die vorhandenen Informationen ändern kann.

Syntax

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

Parameter

[in] unnamedParam1

Behandeln des übergeordneten Fensters des Dialogfelds.

[in] unnamedParam2

Zeigen Sie auf eine mit Null beendete 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.

[in] unnamedParam3

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen eines vorhandenen Eintrags in der Telefonbuchdatei angibt.

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_BUFFER_INVALID	Der Eingabepuffer für das Telefonbuch ist ungültig.
ERROR_CANNOT_OPEN_PHONEBOOK	Das Telefonbuch ist beschädigt oder fehlende Komponenten.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	Der Telefonbucheintrag ist nicht vorhanden.

Bemerkungen

Legen Sie beim Aufrufen RasEntryDlgjedes Element der RASENTRYDLG- struktur fest, die an lpinfo übergeben wird, außer:

dwSize = sizeof(RASENTRYDLG)
hwndOwner = der hwnd Parameter oben

Anmerkung

Der ras.h-Header definiert RasEditPhonebookEntry als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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