ldap_parse_monitor_events_response

Parses event data when the result code is LDAP_RES_INTERMEDIATE. This result code indicates that an event has occured. 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_monitor_events_response (
     LDAP                 *ld,
     LDAPMessage          *eventMessage,
     int                  *resultCode,
     char                **errorMessage,
     int                  *badEventsCount,              
     EVT_EventSpecifier  **badEvents,
     int                   freeIt);
  
  

Parameters

ld

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

eventMessage

(IN) Pointer to the LDAPMessage returned by ldap_result.

resultCode

(OUT) Returns the responseCode from the server.

errorMessage

(OUT) Returns the error message from the server, may be NULL if no error messages are requested. This memory must be freed using ldap_memfree.

badEventsCount

(OUT) Returns the number of bad events from the server, may be NULL if no data is requested. This memory must be freed using ldapx_memfree.

badEvents

(OUT) If the value of responseCode is LDAP_PROTOCOL_ERROR, this parameter receives an array of EVT_EventSpecifier structures identifying the unrecognized events (free with ldap_event_free). Otherwise, the parameter is set to NULL.

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]

See LDAP Result Codes for information

See Also

ldap_monitor_events, ldap_parse_ds_event, ldap_event_free