ldap_monitor_events

Sends an EventMonitorRequest extended operation to the server. 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_monitor_events (
     LDAP                  *ld,
     int                    eventCount,
     EVT_EventSpecifier[]  *events,
     int                   *msgId);

Parameters

ld

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

eventCount

(IN) The number of events you wish to monitor.

events

(IN) An array of EVT_EventSpecifier structures describing the events the application wishes to monitor. The number of events is specified by eventCount.

msgId

(OUT) Set to the message id of the request if the ldap_monitor_event call succeeds. The value is undefined if the function returns a value other than LDAP_SUCCESS.

Return Values

LDAP_SUCCESS

Request was successfully sent

[Other value]

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

Remarks

The ldap_monitor_events function sends a MonitorEventRequest extended operation to the server. The function sends the request asynchronously; it does not wait for a response from the server.

To include a filter with your request to limit the events returned see ldap_monitor_events_filtered.

See Also

ldap_parse_ds_event, ldap_parse_monitor_events_response, ldap_event_free, ldap_monitor_events_filtered