Метод IDsAdminNotifyHandler::Begin (dsadmin.h)

Статья
08/23/2023

Метод IDsAdminNotifyHandler::Begin вызывается при возникновении события, запрошенного обработчиком уведомлений. Обработчик уведомлений указывает события для получения уведомлений при вызове идентификатораAdminNotifyHandler::Initialize .

Синтаксис

HRESULT Begin(
  [in]  ULONG       uEvent,
  [in]  IDataObject *pArg1,
  [in]  IDataObject *pArg2,
  [out] ULONG       *puFlags,
  [out] BSTR        *pBstr
);

Параметры

[in] uEvent

Содержит значение , указывающее тип происходящего события. Это может быть одно из следующих значений.

DSA_NOTIFY_DEL

Объект удаляется.

DSA_NOTIFY_REN

Объект переименован.

DSA_NOTIFY_MOV

Объект перемещается в другой контейнер.

DSA_NOTIFY_PROP

Изменяется одно или несколько свойств объекта .

[in] pArg1

Указатель на интерфейс IDataObject , поддерживающий формат буфера обмена CFSTR_DSOBJECTNAMES . Содержимое объекта данных зависит от значения uEvent. Дополнительные сведения см. в разделе «Примечания».

[in] pArg2

Указатель на интерфейс IDataObject , поддерживающий формат буфера обмена CFSTR_DSOBJECTNAMES . Значение этого параметра и содержимое объекта данных зависят от значения uEvent. Дополнительные сведения см. в разделе «Примечания».

[out] puFlags

Указатель на значение ULONG , которое получает набор флагов, которые изменяют поведение обработчика уведомлений в диалоговом окне подтверждения уведомления. Это может быть ноль или сочетание одного или нескольких из следующих значений.

DSA_NOTIFY_FLAG_ADDITIONAL_DATA

Если этот флаг установлен, выбрана запись для этого обработчика уведомлений в диалоговом окне подтверждения. Если этот флаг не установлен, запись для этого обработчика уведомлений в диалоговом окне подтверждения не выбрана.

DSA_NOTIFY_FLAG_FORCE_ADDITIONAL_DATA

Если этот флаг установлен, запись для этого обработчика уведомлений в диалоговом окне подтверждения будет отключена, и пользователь не сможет изменить состояние выбора.

[out] pBstr

Указатель на BSTR , получающий строку, содержащую имя и (или) описание обработчика уведомлений. Эта строка отображается в диалоговом окне подтверждения. Эта строка должна быть выделена путем вызова функции SysAllocString . Вызывающий объект должен освободить эту строку, когда она больше не требуется. Если этот параметр получает значение NULL или пустую строку, обработчик уведомлений не добавляется в диалоговое окно подтверждения и не вызывается идентификаторAdminNotifyHandler::Notify .

Возвращаемое значение

Если метод выполнен успешно, возвращается S_OK . Если метод завершается сбоем, возвращается стандартное значение HRESULT .

Значение и содержимое pArg1 и pArg2 зависят от события, обработанного в соответствии с uEvent. В следующем списке объясняется, что pArg1 и pArg2 будут содержаться для каждого типа события.

uEvent	pArg1	pArg2
DSA_NOTIFY_DEL	Содержит удаленный объект.	Не используется. Это значение будет иметь значение NULL.
DSA_NOTIFY_REN	Содержит предыдущее имя объекта.	Содержит новое имя объекта .
DSA_NOTIFY_MOV	Содержит контейнер, из который перемещается объект.	Содержит контейнер, в который перемещается объект .
DSA_NOTIFY_PROP	Содержит объект, для которого были изменены свойства.	Не используется. Это значение будет иметь значение NULL.

Требования


Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	dsadmin.h
DLL	DSAdmin.dll