Directory Services

IDsAdminNotifyHandler::Initialize

The IDsAdminNotifyHandler::Initialize method is called to initialize the notification handler.

HRESULT Initialize( 
  IDataObject* pExtraInfo,
  ULONG* puEventFlags
);

Parameters

pExtraInfo
[in] Not currently used. This parameter will be NULL.
puEventFlags
[out] Pointer to a ULONG value that receives a set of flags that indicate which events the notification handler should receive. This can be a combination of one or more of the following values. If this parameter receives zero, the notification handler will not receive any events.
Value Meaning
DSA_NOTIFY_DEL Notify the handler when an object is deleted.
DSA_NOTIFY_REN Notify the handler when an object is renameed.
DSA_NOTIFY_MOV Notify the handler when an object has been moved.
DSA_NOTIFY_PROP Notify the handler when a property has been changed.
DSA_NOTIFY_ALL Notify the handler in response to all events.

Return Values

If the method succeeds, S_OK is returned. If the method fails, a standard HRESULT value is returned.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Header: Declared in Dsadmin.h.

See Also

IDsAdminNotifyHandler, IDataObject