ldap_parse_ds_event

Parses event data when the ldap result code is LDAP_RES_EXTENDED. This result code Indicates that an error or exceptional situation occured and events will not be monitored. Event monitoring works with eDirectory 8.7 or higher.

LDAP Version:v2 or higher
Library:*ldapsdk.*
NDS Version:8.7 or higher
Platform:NLM, Windows (NT, 95, 98, 2000, XP, Vista 32-bit and 64-bit ), Linux (32-bit and 64-bit), Solaris, AIX, and HP-UX

Syntax

  #include <ldap.h>
  
  int ldap_parse_ds_event (
     LDAP                *ld,
     LDAPMessage         *eventMessage,
     int                 *eventType,
     int                 *eventResult,
     void               **eventData,
     int                  freeIt);

Parameters

ld

(IN) Points to the handle for the LDAP session.

eventMessage

(IN) Pointer to the LDAPMessage returned by ldap_result.

eventType

(OUT) Recieves the type of the event.

eventResult

(OUT) Recieves the result associated with the event.

eventData

(OUT) a pointer to a pointer to a structure containing the data returned by this particular event. The structure is allocated by this function. The type of the structure is determined by the eventType. If the event does not have associated data the pointer will be set to NULL. When the application no longer needs the data it should free the data by calling the ldap_event_free function.

freeIt

(IN) If non-zero, the function will free the memory referenced by the eventMessage parameter.

Return Values

LDAP_SUCCESS

Request was successfully sent

[Other value]

Non-zero codes indicate errors. See LDAP Return Codes for information.

See Also

ldap_monitor_events, ldap_parse_monitor_events_response, ldap_event_free