共用方式為


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

MMC_TASK_DISPLAY_OBJECT結構的指標,該嵌入式管理單元必須填入,才能指定要顯示為 pszGroup 所指定任務台的背景影像。

請注意,MMC (呼叫端) 為MMC_TASK_DISPLAY_OBJECT結構配置記憶體。

傳回值

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

備註

使用 COM API 函式 CoTaskMemAlloc (或對 等) 和 MMC 釋放 pTDO 參數中指定的MMC_TASK_DISPLAY_BITMAP或 MMC_TASK_DISPLAY_SYMBOL 結構中的字串。

需求

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

另請參閱

IExtendTaskPad

MMC_TASK_DISPLAY_BITMAP

MMC_TASK_DISPLAY_OBJECT

MMC_TASK_DISPLAY_SYMBOL