ldap_modify_ext_s, fonction (winldap.h)
La fonction ldap_modify_ext_s modifie une entrée existante.
Syntaxe
WINLDAPAPI ULONG LDAPAPI ldap_modify_ext_s(
[in] LDAP *ld,
[in] const PSTR dn,
[in] LDAPModA * [] mods,
[in] PLDAPControlA *ServerControls,
[in] PLDAPControlA *ClientControls
);
Paramètres
[in] ld
Handle de session.
[in] dn
Pointeur vers une chaîne terminée par null qui contient le nom de l’entrée à modifier.
[in] mods
Tableau terminé par un caractère Null des modifications à apporter à l’entrée.
[in] ServerControls
Liste des contrôles serveur LDAP.
[in] ClientControls
Liste des contrôles clients.
Valeur retournée
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_modify_ext_s lance une opération synchrone pour modifier une entrée existante. Si des valeurs sont ajoutées ou remplacées dans l’entrée, la fonction crée l’attribut, si nécessaire. Si des valeurs sont supprimées et qu’aucune valeur n’est conservée, la fonction supprime l’attribut . Toutes les modifications sont effectuées dans l’ordre dans lequel elles sont répertoriées.
Les paramètres et les effets de ldap_modify_ext_s subsument ceux de ldap_modify_s. La routine étendue inclut des paramètres supplémentaires pour prendre en charge les contrôles client et serveur.
Multithreading : les appels à ldap_modify_ext_s sont thread-safe.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |