Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
ldap_extended_operation
Collapse the table of content
Expand the table of content

ldap_extended_operation function

The ldap_extended_operation function enables you to pass extended LDAP operations to the server.

Syntax


ULONG ldap_extended_operation(
  _In_  LDAP          *ld,
  _In_  PCHAR         Oid,
  _In_  struct berval *Data,
  _In_  PLDAPControl  *ServerControls,
  _In_  PLDAPControl  *ClientControls,
  _Out_ ULONG         *MessageNumber
);

Parameters

ld [in]

The session handle.

Oid [in]

A pointer to a null-terminated string that contains the dotted object identifier text string that names the request.

Data [in]

The arbitrary data required by the operation. If NULL, no data is sent to the server.

ServerControls [in]

Optional. A list of LDAP server controls. Set this parameter to NULL, if not used.

ClientControls [in]

Optional. A list of client controls. Set this parameter to NULL, if not used.

MessageNumber [out]

The message ID for the request.

Return value

If the function succeeds, LDAP_SUCCESS is returned.

If the function fails, an error code is returned. For more information, see Return Values.

Remarks

The ldap_extended_operation function enables 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.

As an asynchronous function, ldap_extended_operation returns a message ID for the operation. Call ldap_result with the message ID to get the result of the operation. To cancel an asynchronous operation, call ldap_abandon.

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

Multithreading: The ldap_extended_operation function is thread-safe.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Header

Winldap.h

Library

Wldap32.lib

DLL

Wldap32.dll

Unicode and ANSI names

ldap_extended_operationW (Unicode) and ldap_extended_operationA (ANSI)

See also

Functions
ldap_abandon
ldap_close_extended_op
ldap_result
Return Values

 

 

Show:
© 2015 Microsoft