fonction ldap_abandon (winldap.h)
Un client appelle ldap_abandon pour annuler un appel LDAP asynchrone in-process.
Syntaxe
WINLDAPAPI ULONG LDAPAPI ldap_abandon(
[in] LDAP *ld,
[in] ULONG msgid
);
Paramètres
[in] ld
Handle de session.
[in] msgid
ID de message de l’appel à annuler. Les fonctions asynchrones, telles que ldap_search et ldap_modify, retournent cet ID de message lorsqu’elles lancent une opération.
Valeur retournée
Si la fonction réussit, c’est-à-dire que si l’opération d’annulation réussit, la valeur de retour est zéro.
Si la fonction échoue, la valeur de retour est –1.
Remarques
La fonction ldap_abandon vérifie d’abord que l’opération est terminée. Si c’est le cas, l’ID de message est supprimé ; sinon, l’appel est envoyé au serveur pour annuler l’opération. N’oubliez pas qu’un appel réussi à ldap_abandon détruit l’ID du message. Par conséquent, vous ne pouvez pas appeler ldap_result pour obtenir des résultats avec cet ID de message, même si le serveur a terminé l’opération.
Il n’existe aucune réponse du serveur à ldap_abandon ; par conséquent, il n’y a aucune garantie que l’appel a atteint le serveur.
Multithreading : les appels à ldap_abandon sont thread-safe.
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 |