ldap_monitor_events_filtered

Sends a filtered 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_filtered (
     LDAP                          *ld,
     int                            eventCount,
     EVT_FilteredEventSpecifier[]  *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_FilteredEventSpecifier structures describing the events the application wishes to monitor including an event filter. 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_filtered function sends a FilteredMonitorEventRequest extended operation to the server. The function sends the request asynchronously; it does not wait for a response from the server.

See Also

ldap_parse_ds_event, ldap_parse_monitor_events_response, ldap_event_free, ldap_monitor_events