ldap_err2stringW, fonction (winldap.h)

La fonction ldap_err2string convertit un code d’erreur LDAP numérique en chaîne de caractères terminée par null qui décrit l’erreur.

Syntaxe

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

Paramètres

[in] err

Code d’erreur LDAP tel que retourné par une autre fonction LDAP.

Valeur retournée

Si la fonction réussit, un pointeur vers une chaîne de caractères terminée par null qui décrit l’erreur est retourné.

Si la fonction échoue, un pointeur vers NULL est retourné.

Remarques

Appelez ldap_err2string pour convertir tout code d’erreur LDAP numérique en un message de chaîne de caractères informatif et terminé par null qui décrit l’erreur. N’oubliez pas que certains appels asynchrones retournent -1. Dans ce cas, utilisez LdapGetLastError pour récupérer le code d’erreur LDAP, puis utilisez ldap_err2string sur cette valeur.

La valeur de retour est un pointeur statique vers la chaîne de caractères. Ne libérez pas cette chaîne.

Notes

L’en-tête winldap.h définit ldap_err2string en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	winldap.h
Bibliothèque	Wldap32.lib
DLL	Wldap32.dll

Voir aussi

Fonctions

Valeurs retournées