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 |