IExtendTaskPad::GetBackground 方法 (mmc.h)

IExtendTaskPad::GetBackground 方法使 MMC 能够获取任务板的背景图像,以在使用 MMC 任务板模板的任务板中显示。

语法

HRESULT GetBackground(
  [in]  LPOLESTR                pszGroup,
  [out] MMC_TASK_DISPLAY_OBJECT *pTDO
);

parameters

[in] pszGroup

指向以 null 结尾的字符串的指针,该字符串包含标识任务板的组名称。 组名称是 MMC 调用 IComponent::GetResultViewType 以显示任务板时,在 ppViewType 参数中传递的字符串中的哈希 (#) 后面的字符串。 如果未指定组名称,则 pszGroup 为 NULL 字符串。

[out] pTDO

指向 MMC_TASK_DISPLAY_OBJECT 结构的指针,管理单元必须填充该结构,以指定要显示为 pszGroup 指定的任务板的背景的图像。

请注意,调用方 (MMC) 为MMC_TASK_DISPLAY_OBJECT结构分配内存。

返回值

此方法可以返回其中一个值。

注解

使用 COM API 函数 CoTaskMemAlloc (或等效 ) 分配 pTDO 参数中指定的MMC_TASK_DISPLAY_BITMAP或MMC_TASK_DISPLAY_SYMBOL结构中的字符串,MMC 将释放它。

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 mmc.h

另请参阅

IExtendTaskPad

MMC_TASK_DISPLAY_BITMAP

MMC_TASK_DISPLAY_OBJECT

MMC_TASK_DISPLAY_SYMBOL