IDsAdminNotifyHandler：：Begin 方法 (dsadmin.h)

项目
08/23/2023

发生通知处理程序请求的事件时，将调用 IDsAdminNotifyHandler：：Begin 方法。通知处理程序指定要在调用 IDsAdminNotifyHandler：：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

指向支持CFSTR_DSOBJECTNAMES剪贴板格式的 IDataObject 接口的指针。数据对象的内容将因 uEvent 的值而异。有关详细信息，请参见“备注”部分。

[in] pArg2

指向支持CFSTR_DSOBJECTNAMES剪贴板格式的 IDataObject 接口的指针。此参数的值和数据对象的内容将因 uEvent 的值而异。有关详细信息，请参见“备注”部分。

[out] puFlags

指向 ULONG 值的指针，该值接收一组标志，这些标志修改通知确认对话框中通知处理程序的行为。这可以是零，也可以是以下一个或多个值的组合。

DSA_NOTIFY_FLAG_ADDITIONAL_DATA

如果设置了此标志，则会在确认对话框中选择此通知处理程序的条目。如果未设置此标志，则不会在确认对话框中选择此通知处理程序的条目。

DSA_NOTIFY_FLAG_FORCE_ADDITIONAL_DATA

如果设置了此标志，则会禁用确认对话框中此通知处理程序的条目，并且用户无法更改选择状态。

[out] pBstr

指向 BSTR 的指针，该字符串接收包含通知处理程序的名称和/或说明的字符串。此字符串显示在确认对话框中。必须通过调用 SysAllocString 函数来分配此字符串。当不再需要此字符串时，调用方必须释放该字符串。如果此参数收到 NULL 或空字符串，则通知处理程序不会添加到确认对话框中，并且不会调用 IDsAdminNotifyHandler：：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
标头	dsadmin.h
DLL	DSAdmin.dll