共用方式為


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_DSOBJECTNAMESIDataObject介面的指標。 資料物件的內容會根據 uEvent的值而有所不同。 如需詳細資訊,請參閱<備註>一節。

[in] pArg2

支援剪貼簿格式CFSTR_DSOBJECTNAMESIDataObject介面的指標。 此參數的值和資料物件的內容會根據 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 值。

備註

pArg1pArg2的值和內容會根據uEvent所處理的事件而有所不同。 下列清單說明每個不同事件種類 pArg1pArg2 將包含哪些專案。

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

另請參閱

CFSTR_DSOBJECTNAMES

IDataObject

IDsAdminNotifyHandler

IDsAdminNotifyHandler::Initialize

SysAllocString