ldap_extended_operation (Windows CE 5.0)

Send Feedback

This function allows you to pass extended LDAP operations to the server.

ULONG ldap_extended_operation(LDAP* ld,UNICODE PTCHAROid,struct berval* Data,LDAPControl** ServerControls,LDAPControl** ClientControls,ULONG* MessageNumber);

Parameters

  • ld
    [in] Session handle.
  • Oid
    [in] Dotted object identifier (OID) text string naming the request.
  • Data
    [in] Arbitrary data required by the operation. If NULL, no data is sent to the server.
  • ServerControls
    [in] List of LDAP server controls.
  • ClientControls
    [in] List of client controls.
  • MessageNumber
    [out] Message identifier for the request.

Return Values

If this function succeeds, the return value is LDAP_SUCCESS.

If this function fails, it returns an error code. See the LDAP_RETCODE enumeration for a list of possible return values.

Remarks

This function allows a client to send an extended request (free for all) to an LDAP 3 (or later) server. The functionality is open and the client request can be for any operation, requiring single or multiple responses.

As an asynchronous function, this function returns a message identifier for the operation. Call the ldap_result function with the message identifier to get the result of the operation. To cancel an asynchronous operation before it has completed, call the ldap_abandon function.

Because of the open nature of the request, the client must call the ldap_close_extended_op function to terminate the request.

In a multithreading environment, calls to ldap_extended_operation are thread-safe.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Winldap.h.
Link Library: Wldap32.lib.

See Also

LDAP_RETCODE | ldap_abandon | ldap_close_extended_op | ldap_result

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.