ldap_create_chaining_audit_control()--Create an Audit Control

 #include <ldap.h>  

 LDAPControl * ldap_create_chaining_audit_control (
         char           **listOfRequestIDs,
         char           *clientIP,
         int            criticality)
 

The ldap_create_chaining_audit_control() function is used to create a directory server Audit control. The Audit control is used to provide information about the origin of a client request when an application is acting as a proxy for requests sent to a directory server.

Parameters

listOfRequestIDs

(Input)

A list of strings used to identify the original client, or chain of clients, from which the request originated. The format of the string is defined by the application. The list is terminated with a null pointer.

clientIP

(Input)

A string containing the IP address of the client on whose behalf a request id being sent. The string may contain other identifying information, but is audited as an IP address.

criticality

(Input)

The criticality value to be used for the generated control. Possible values are:

0

The control can be ignored by the server if the server does not support the control.

1

The control must be honored by the server or the request to which the control is attached must be rejected by the server.

Authorities and Locks

No IBM^® i authority is required. Authority to use the Audit control is determined by the LDAP server.

Return Value

Pointer to LDAPControl

Pointer to a LDAPControl that can be used with other LDAP APIs. The caller is responsible for freeing the allocated LDAPControl structure by calling ldap_control_free().

NULL

A memory allocation error or other error occurred. No further error information is available.

Related Information

• ldap_control_free()--Free Storage Allocated by the LDAP Library.

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