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。