ldap_abandon (Windows CE 5.0)
This function is called by a client to cancel an in-progress asynchronous LDAP call.
ULONG ldap_abandon(LDAP* ld,ULONGmsgid);
Parameters
- ld
[in] Session handle. - msgid
[out] Message identifier of the call to be canceled. Asynchronous functions return this message identifier when they initiate an operation.
Return Values
If the function succeeds (the cancellation is successful), the return value is 0.
If this function fails, the return value is –1.
Remarks
This function first checks to see whether the operation has been completed. If it has, the message identifier is deleted; otherwise, the call goes to the server to cancel the operation.
Note A successful call to this function destroys the message identifier. Therefore, you cannot call the ldap_result function to obtain results with that message identifier, even if the server completed the operation.
There is no server response to ldap_abandon; thus, there is no guarantee that the call reached the server.
In a multithreading environment, calls to this function are thread-safe.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Winldap.h.
Link Library: Wldap32.lib.
See Also
Send Feedback on this topic to the authors