ldap_result2error()--Retrieve LDAP Error Information

 #include <ldap.h>

 int ldap_result2error(
                LDAP         *ld,
                LDAPMessage  *res,
                int           freeit)

The ldap_result2error() API takes a result as produced by ldap_result() or ldap_search_s(), and returns the corresponding error code.

Authorities and Locks

No i5/OS authority is required.

Parameters

ld

(Input) Specifies the LDAP pointer returned by a previous call to ldap_init(), ldap_ssl_init(), or ldap_open().

res

(Input/Output) Specifies the result, as produced by ldap_result(), to be converted to the error code with which it is associated.

freeit

(Input) Specifies whether or not the result, res, should be freed as a result of calling ldap_result2error(). If non-zero, the result, res, will be freed by the call. If zero, res will not be freed by the call.

Return Value

LDAP error code

The result of the ldap request in res.

Error Conditions

The ldap_result2error() function will return an LDAP error code. See LDAP Client API Error Conditions for possible LDAP error codes.

Error Messages

The following message may be sent from this function.

Related Information

• ldap_err2string() -- Convert LDAP error indication to a string.
• ldap_get_errno() -- Retrieve error information.
• ldap_perror() -- Print an LDAP error indication to standard error.
• ldap_result() -- Retrieve result of an asynchronous LDAP operation.
• ldap_search_s() -- Perform an LDAP search operation (synchronous).