ldap_create_account_status_request()--Create an Account Status Request Value

Syntax

 #include < ldap.h >

 struct berval * ldap_create_account_status_request(const char *entryDN)

  Service Program Name: QSYS/QGLDCLNT

  Default Public Authority: *USE

  Threadsafe: Yes

The ldap_create_account_status_request() function is used to create a request berval for the Account Status extended operation. The Account Status extended operation is used to request the status (open, locked or expired) of an entry that contains a userPassword attribute.

Parameters

entryDN: (Input)
Distinguished name (DN) of the account to be queried in the request.

Authorities and Locks

No IBM^® i authority is required. Authority to use the Account Status extended operation is determined by the LDAP server.

Return Value

Pointer to berval structure: Pointer to a berval structure that can be specified as the reqdata parameter on the ldap_extended_operation() API. The caller is responsible for freeing the allocated berval structure by calling ber_bvfree().
NULL: A memory allocation error or other error occurred. No further error information is available.

Related Information

ber_bvfree() -- Free a Berval Structure
ldap_extended_operation() -- Perform extended operation
ldap_extended_operation_s() -- Perform extended operation synchronously

API introduced: V6R1

[ Back to top | LDAP APIs | APIs by category ]