ldap_compare_ext_sW, fonction (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 un caractère Null qui contient la valeur d’attribut de chaîne à comparer à la valeur d’attribut. Définissez sur NULL si elle n’est pas utilisée.
[in] Data
Valeur d’attribut berval à comparer à la valeur d’attribut. Définissez sur NULL si elle n’est pas utilisée.
[in] ServerControls
facultatif. Liste des contrôles serveur LDAP. Définissez sur NULL si elle n’est pas utilisée.
[in] ClientControls
facultatif. Liste des contrôles clients LDAP. Définissez sur NULL si elle n’est pas utilisée.
Valeur retournée
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é.
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 subsument 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 Value pour comparer des valeurs de chaîne ou utilisez le paramètre Data pour comparer des 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.
Notes
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. 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 |