ldap_err2stringW-Funktion (winldap.h)

Die funktion ldap_err2string konvertiert einen numerischen LDAP-Fehlercode in eine NULL-endende Zeichenfolge, die den Fehler beschreibt.

Syntax

WINLDAPAPI PWCHAR LDAPAPI ldap_err2stringW(
  [in] ULONG err
);

Parameter

[in] err

Ein LDAP-Fehlercode, der von einer anderen LDAP-Funktion zurückgegeben wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ein Zeiger auf eine NULL-endende Zeichenfolge zurückgegeben, die den Fehler beschreibt.

Wenn die Funktion fehlschlägt, wird ein Zeiger auf NULL zurückgegeben.

Hinweise

Rufen Sie ldap_err2string auf, um einen beliebigen numerischen LDAP-Fehlercode in eine informative, null-endende Zeichenfolgenmeldung zu konvertieren, die den Fehler beschreibt. Beachten Sie, dass einige der asynchronen Aufrufe -1 zurückgeben. Verwenden Sie in diesem Fall LdapGetLastError , um den LDAP-Fehlercode abzurufen, und verwenden Sie dann ldap_err2string für diesen Wert.

Der Rückgabewert ist ein statischer Zeiger auf die Zeichenfolge. Geben Sie diese Zeichenfolge nicht frei.

Hinweis

Der winldap.h-Header definiert ldap_err2string 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

Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	winldap.h
Bibliothek	Wldap32.lib
DLL	Wldap32.dll

Siehe auch

Funktionen

Rückgabewerte