ldap_abandon

  • Article

This function is called by a client to cancel an in-progress asynchronous LDAP call.

ULONG ldap_abandon(
  LDAP* ld,
  ULONG msgid
);

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

ldap_result

 Last updated on Friday, April 09, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.