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
タスクパッド上の CIC コントロールから返される情報を含む VARIANT 構造体へのポインター。
MMC タスクパッド テンプレートを使用したタスクパッド
MMC が提供するタスクパッドの場合、VARIANT 構造体には、タスクパッド タスクまたはリスト ビュー ボタンのコマンド ID が含まれています。
vt フィールドがVT_I4され、lVal フィールドには、ed されたタスクパッド タスクまたはリスト ビュー ボタンのコマンド ID が含まれています。 リスト ビュー ボタンは、リスト ビューのタスクパッドにのみ適用されます。
タスク コマンド ID は、タスク パッドのセットアップ中にそのタスクの情報を取得するときに MMC が呼び出す IEnumTASK::Next メソッドで渡される、MMC_TASK構造体の nCommandID メンバーで指定されます。
リスト ビュー ボタンは、 MMC_LISTPAD_INFO 構造体の szButtonText メンバーで指定されたボタンです。このボタンは、リスト ビュー タスクパッドの設定時に MMC が呼び出す IExtendTaskPad::GetListPadInfo メソッドで渡されます。 リスト ビュー ボタンのコマンド ID は、MMC_LISTPAD_INFOの nCommandID メンバーで指定されます。
カスタム HTML ページを使用したタスクパッド
カスタム タスクパッドの場合、VARIANT 構造体には、カスタム HTML ページ上のスクリプトが CIC オブジェクト TaskNotify メソッドを通過する必要がある任意のデータを含めることができます
[in] param
タスクパッド上の CIC コントロールから返される情報を含む VARIANT 構造体へのポインター。
MMC タスクパッド テンプレートを使用するタスクパッドでは、このパラメーターは無視されます。 ただし、カスタム タスクパッドはそれを使用して、追加の値をスナップインに戻すことができます。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
解説
スナップインは、pdo ポインターを使用して、タスクパッドを所有するスコープ項目を識別できます。その後、arg パラメーターで返される VARIANT 値によってタスクを識別できます。 タスクパッドがリスト ビューのタスクパッドの場合、スナップインは IResultData インターフェイスを使用して、結果一覧で選択した項目 (または複数選択がサポートされている場合はアイテム) を識別できます。 このデータに基づいて、スナップインは適切なオブジェクトに対して適切なアクションを実行できます。
リスト ビュータスクパッドに対してタスクパッドリストビューボタンが表示されている場合、スナップインは arg パラメーターで返される VARIANT 値によって特定のタスクパッドのボタンを識別できます。
カスタム タスクパッドは、arg パラメーターと param パラメーターで送信する必要があると判断した任意の値を渡すことができます。
要件
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | mmc.h |