fonction ldap_modify (winldap.h)
La fonction ldap_modify modifie une entrée existante.
Syntaxe
WINLDAPAPI ULONG LDAPAPI ldap_modify(
[in] LDAP *ld,
[in] PSTR dn,
[in] LDAPModA * [] mods
);
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 null des modifications à apporter à l’entrée.
Valeur retournée
Si la fonction réussit, elle retourne l’ID de message de l’opération de modification.
Si la fonction échoue, elle retourne –1 et définit les paramètres d’erreur de session dans la structure de données LDAP .
Remarques
La fonction ldap_modify 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 ne reste, la fonction supprime l’attribut. Toutes les modifications sont effectuées dans l’ordre dans lequel elles sont répertoriées.
En tant que fonction asynchrone, ldap_modify retourne un ID de message pour l’opération. Appelez ldap_result avec l’ID de message pour obtenir le résultat de l’opération. Pour annuler une opération asynchrone avant qu’elle ne soit terminée, appelez ldap_abandon.
Si vous préférez que la fonction retourne directement les résultats, utilisez la routine synchrone ldap_modify_s. Utilisez ldap_modify_ext ou ldap_modify_ext_s si vous avez besoin d’une prise en charge des contrôles client et serveur LDAP 3.
Multithreading : les appels à ldap_modify sont thread-safe, à condition que LdapGetLastError soit utilisé pour récupérer le code d’erreur de session réel lorsque l’appel de fonction retourne le code d’échec -1.
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 |