ldap_modify_ext, fonction (winldap.h)
La fonction ldap_modify_ext modifie une entrée existante.
Syntaxe
WINLDAPAPI ULONG LDAPAPI ldap_modify_ext(
[in] LDAP *ld,
[in] const PSTR dn,
[in] LDAPModA * [] mods,
[in] PLDAPControlA *ServerControls,
[in] PLDAPControlA *ClientControls,
[out] ULONG *MessageNumber
);
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
[out] MessageNumber
Ce paramètre de résultat est défini sur l’ID de message de la demande si l’appel réussit.
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 lance une opération asynchrone 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 subsument ceux de ldap_modify. La routine étendue inclut des paramètres supplémentaires pour prendre en charge les contrôles client et serveur, ainsi que la sécurité des threads.
En cas de réussite, ldap_modify_ext renvoie l’ID de message de l’opération dans le paramètre MessageNumber . Appelez ldap_result avec l’ID de message pour obtenir le résultat de l’opération. Si vous préférez que la fonction retourne directement le résultat, utilisez la fonction étendue synchrone ldap_modify_ext_s.
Multithreading : les appels à ldap_modify_ext 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 |