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 |