共用方式為

IExtendTaskPad：：TaskNotify 方法 (mmc.h)

  • 發行項

IExtendTaskPad：：TaskNotify方法可讓 MMC 在擴充工作時通知嵌入式管理單元。 如果任務板是清單檢視任務板，MMC 也會在延伸清單檢視按鈕時呼叫 IExtendTaskPad：：TaskNotify 。

語法

HRESULT TaskNotify(
  [in] IDataObject *pdo,
  [in] VARIANT     *arg,
  [in] VARIANT     *param
);

參數

[in] pdo

擁有任務板之範圍專案之資料物件的指標。 如果您的嵌入式管理單元擁有顯示任務板的專案，pdo 是該專案的指標。 如果您的嵌入式管理單元擴充另一個嵌入式管理單元的工作板，pdo 是擁有任務板之嵌入式管理單元中專案的指標。

[in] arg

VARIANT 結構的指標，其中包含從任務板上的 CIC 控制項傳回的資訊。

使用 MMC 工作板範本的工作板

針對 MMC 提供的工作板，VARIANT 結構包含任務板工作或清單檢視按鈕的命令識別碼。

vt 欄位VT_I4，而 lVal 欄位包含任務板工作或清單檢視按鈕的命令識別碼。 清單檢視按鈕僅適用于清單檢視任務板。

工作命令識別碼是在 MMC_TASK 結構的 nCommandID 成員中指定，此成員會在 MMC 在設定任務板期間擷取該工作的資訊時，傳入 IEnumTASK：：Next 方法中。

清單檢視按鈕是在 MMC_LISTPAD_INFO 結構的 szButtonText 成員中指定的按鈕，它會在 MMC 設定清單檢視任務板時呼叫的 IExtendTaskPad：：GetListPadInfo 方法中傳遞。 清單檢視按鈕命令識別碼是在 MMC_LISTPAD_INFO 的 nCommandID 成員中指定。

使用自訂 HTML 頁面的工作板

針對自訂任務板，VARIANT 結構可以包含自訂 HTML 頁面上腳本想要通過 CIC 物件 TaskNotify 方法的任何資料

[in] param

VARIANT 結構的指標，其中包含從任務板上的 CIC 控制項傳回的資訊。

使用 MMC 工作板範本的工作板會忽略此參數。 不過，自訂工作板可以用來將額外的值傳回嵌入式管理單元。

傳回值

這個方法可以傳回其中一個值。

備註

嵌入式管理單元可以使用 pdo 指標來識別擁有任務板的範圍專案;然後，它可以透過 arg 參數中傳回的 VARIANT 值來識別工作。 如果任務板是清單檢視任務板，嵌入式管理單元可以使用 IResultData 介面在結果清單中) 支援多重選取專案 (或專案。 根據此資料，嵌入式管理單元可以在適當的物件上執行適當的動作。

如果任務板清單檢視按鈕是針對清單檢視工作板所設定，嵌入式管理單元可以透過 arg 參數中傳回的 VARIANT 值來識別特定任務板的按鈕。

自訂任務板可以傳遞它判斷的任何值，應該在 arg 和 param 參數中傳送。

需求

   
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 mmc.h

另請參閱

IEnumTASK

IExtendTaskPad