IDsAdminNotifyHandler：：Begin 方法 (dsadmin.h)
发生通知处理程序请求的事件时，将调用 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 |