función ldap_abandon (winldap.h)
Un cliente llama a ldap_abandon para cancelar una llamada LDAP asincrónica en proceso.
Sintaxis
WINLDAPAPI ULONG LDAPAPI ldap_abandon(
[in] LDAP *ld,
[in] ULONG msgid
);
Parámetros
[in] ld
Identificador de sesión.
[in] msgid
Identificador de mensaje de la llamada que se va a cancelar. Las funciones asincrónicas, como ldap_search y ldap_modify, devuelven este identificador de mensaje cuando inician una operación.
Valor devuelto
Si la función se ejecuta correctamente, es decir, si la operación de cancelación es correcta, el valor devuelto es cero.
Si se produce un error en la función, el valor devuelto es –1.
Comentarios
La función ldap_abandon comprueba primero que se ha completado la operación. Si lo tiene, se elimina el identificador del mensaje; de lo contrario, la llamada va al servidor para cancelar la operación. Tenga en cuenta que una llamada correcta a ldap_abandon destruye el identificador del mensaje. Por lo tanto, no puede llamar a ldap_result para obtener resultados con ese identificador de mensaje, incluso si el servidor completó la operación.
No hay respuesta de servidor a ldap_abandon; por lo tanto, no hay ninguna garantía de que la llamada llegue al servidor.
Multithreading: las llamadas a ldap_abandon son seguras para subprocesos.
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | winldap.h |
| Library | Wldap32.lib |
| Archivo DLL | Wldap32.dll |