ldap_err2stringW Funktion (winldap.h)

Die funktion ldap_err2string konvertiert einen numerischen LDAP-Fehlercode in eine null-beendete Zeichenzeichenfolge, 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 verläuft, wird ein Zeiger auf eine null-beendete Zeichenzeichenfolge 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 numerischen LDAP-Fehlercode in eine informative, null-beendete Zeichenzeichenfolgenmeldung 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 Zeichenzeichenfolge. Diese Zeichenfolge nicht freigeben.

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 codierungsneutralen Aliase mit Code, der nicht codierungsneutral ist, kann zu Ü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