IExtendTaskPad::GetBackground メソッド (mmc.h)
IExtendTaskPad::GetBackground メソッドを使用すると、MMC は、MMC タスクパッド テンプレートを使用するタスクパッドに表示するタスクパッドの背景画像を取得できます。
構文
HRESULT GetBackground(
[in] LPOLESTR pszGroup,
[out] MMC_TASK_DISPLAY_OBJECT *pTDO
);
パラメーター
[in] pszGroup
タスクパッドを識別するグループ名を含む null で終わる文字列へのポインター。 グループ名は、MMC が IComponent::GetResultViewType を呼び出してタスクパッドを表示するときに ppViewType パラメーターで渡される文字列のハッシュ (#) に続く文字列です。 グループ名が指定されていない場合、pszGroup は NULL 文字列です。
[out] pTDO
pszGroup で指定されたタスクパッドの背景として表示するイメージを指定するために、スナップインが入力する必要がある MMC_TASK_DISPLAY_OBJECT構造体への ポインター。
呼び出し元 (MMC) は、MMC_TASK_DISPLAY_OBJECT構造体のメモリを割り当てることに注意してください。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
解説
pTDO パラメーターで指定された MMC_TASK_DISPLAY_BITMAP または MMC_TASK_DISPLAY_SYMBOL 構造体に、COM API 関数 CoTaskMemAlloc (またはそれに相当する) を使用して文字列を割り当てると、MMC によって解放されます。
要件
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | mmc.h |