fonction ldap_compare_ext_sW (winldap.h)

Utilisez la fonction ldap_compare_ext_s pour déterminer si un attribut, pour une entrée donnée, contient une valeur connue.

Syntaxe

WINLDAPAPI ULONG LDAPAPI ldap_compare_ext_sW(
  [in] LDAP          *ld,
  [in] const PWSTR   dn,
  [in] const PWSTR   Attr,
  [in] const PWSTR   Value,
  [in] berval        *Data,
  [in] PLDAPControlW *ServerControls,
  [in] PLDAPControlW *ClientControls
);

Paramètres

[in] ld

Handle de session.

[in] dn

Pointeur vers une chaîne terminée par null qui contient le nom unique de l’entrée à comparer.

[in] Attr

Pointeur vers une chaîne terminée par null qui contient l’attribut à comparer.

[in] Value

Pointeur vers une chaîne terminée par null qui contient la valeur d’attribut de chaîne à comparer à la valeur d’attribut. Défini sur NULL s’il n’est pas utilisé.

[in] Data

La valeur d’attribut berval à comparer à la valeur d’attribut. Défini sur NULL s’il n’est pas utilisé.

[in] ServerControls

Optionnel. Liste des contrôles serveur LDAP. Défini sur NULL s’il n’est pas utilisé.

[in] ClientControls

Optionnel. Liste des contrôles clients LDAP. Défini sur NULL s’il n’est pas utilisé.

Valeur de retour

Si la fonction réussit, et que l’attribut et les valeurs connues correspondent, LDAP_COMPARE_TRUE est retourné ; si les valeurs ne correspondent pas, LDAP_COMPARE_FALSE est retournée.

Si la fonction échoue, un code d’erreur est retourné. Pour plus d’informations, consultez Valeurs de retour.

Remarques

La fonction ldap_compare_ext_s lance une opération de comparaison synchrone, en comparant la valeur d’un attribut à une valeur connue. Les paramètres et les effets de ldap_compare_ext_s sous-énumération de ceux de ldap_compare_s. La routine étendue inclut des paramètres supplémentaires pour prendre en charge les contrôles client et serveur, ainsi que la comparaison des valeurs binaires.

Utilisez le paramètre Valeur pour comparer des valeurs de chaîne ou utilisez le paramètre Data pour comparer les données binaires brutes. Définissez le paramètre inutilisé sur NULL. Si aucun paramètre n’est NULL, l’opération de comparaison utilise la valeur dans le paramètre Data.

Multithreading : les appels à ldap_compare_ext_s sont thread-safe.

Note

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

contrôles étendus

Functions

valeurs de retour

à l’aide de contrôles

berval

ldap_compare_s