Freigeben über


ldap_err2stringW-Funktion (winldap.h)

Die ldap_err2string-Funktion konvertiert einen numerischen LDAP-Fehlercode in eine mit Null beendete 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 mit Null beendete Zeichenfolge zurückgegeben, die den Fehler beschreibt.

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

Bemerkungen

Rufen Sie ldap_err2string auf, um numerischen LDAP-Fehlercode in eine informative, null-beendete 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.

Anmerkung

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

Anforderung Wert
mindestens unterstützte Client- Windows Vista
mindestens unterstützte Server- Windows Server 2008
Zielplattform- Fenster
Header- winldap.h
Library Wldap32.lib
DLL- Wldap32.dll

Siehe auch

Funktionen

Rückgabewerte