Lire en anglais

Partager via


fonction ldap_parse_referenceW (winldap.h)

La fonction ldap_parse_reference retourne une liste de références subordonnées dans un message de réponse de recherche.

Syntaxe

WINLDAPAPI ULONG LDAPAPI ldap_parse_referenceW(
  [in]  LDAP        *Connection,
  [in]  LDAPMessage *ResultMessage,
  [out] PWCHAR      **Referrals
);

Paramètres

[in] Connection

Handle de session.

[in] ResultMessage

Pointeur vers une structure LDAPMessage contenant la réponse de recherche.

[out] Referrals

Pointeur vers la liste des références subordonnées. Gratuit avec ldap_value_free.

Valeur de retour

Si la fonction réussit, la valeur de retour est LDAP_SUCCESS.

Si la fonction échoue, elle retourne un code d’erreur. Pour plus d’informations, consultez valeurs de retour.

Remarques

La fonction ldap_parse_reference retourne une liste de références sous la forme d’URL. Appelez cette fonction si un appel à ldap_parse_result indique qu’il existe des références.

Lorsqu’il n’est plus nécessaire, libérez les références pointeur en appelant ldap_value_free.

Notes

L’en-tête winldap.h définit ldap_parse_reference 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. Le mélange 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.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista
serveur minimum pris en charge Windows Server 2008
plateforme cible Windows
d’en-tête winldap.h
bibliothèque Wldap32.lib
DLL Wldap32.dll

Voir aussi

Functions

LDAPMessage

ldap_parse_result

ldap_value_free