funzione ldap_abandon (winldap.h)
Un client chiama ldap_abandon per annullare una chiamata LDAP asincrona in-process.
Sintassi
WINLDAPAPI ULONG LDAPAPI ldap_abandon(
[in] LDAP *ld,
[in] ULONG msgid
);
Parametri
[in] ld
Handle di sessione.
[in] msgid
ID messaggio della chiamata da annullare. Le funzioni asincrone, ad esempio ldap_search e ldap_modify, restituiscono questo ID messaggio quando avviano un'operazione.
Valore restituito
Se la funzione ha esito positivo, ovvero, se l'operazione annulla ha esito positivo, il valore restituito è zero.
Se la funzione ha esito negativo, il valore restituito è –1.
Commenti
La funzione ldap_abandon verifica prima che l'operazione sia stata completata. Se ha, l'ID messaggio viene eliminato; in caso contrario, la chiamata passa al server per annullare l'operazione. Tenere presente che una chiamata riuscita a ldap_abandon elimina l'ID messaggio. Pertanto, non è possibile chiamare ldap_result per ottenere risultati con tale ID messaggio, anche se il server ha completato l'operazione.
Non esiste alcuna risposta server a ldap_abandon; pertanto, non vi è alcuna garanzia che la chiamata ha raggiunto il server.
Multithreading: le chiamate a ldap_abandon sono thread-safe.
Requisiti
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | winldap.h |
| Libreria | Wldap32.lib |
| DLL | Wldap32.dll |