Método IExtendTaskPad::GetBackground (mmc.h)
O método IExtendTaskPad::GetBackground permite que o MMC obtenha a imagem de plano de fundo do bloco de tarefas a ser exibida em blocos de tarefas que usam modelos de bloco de tarefas do MMC.
Sintaxe
HRESULT GetBackground(
[in] LPOLESTR pszGroup,
[out] MMC_TASK_DISPLAY_OBJECT *pTDO
);
Parâmetros
[in] pszGroup
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do grupo que identifica o bloco de tarefas. O nome do grupo é a cadeia de caracteres que segue o hash (#) na cadeia de caracteres passada no parâmetro ppViewType quando o MMC chama IComponent::GetResultViewType para exibir o bloco de tarefas. Se nenhum nome de grupo for especificado, pszGroup será uma cadeia de caracteres NULL .
[out] pTDO
Um ponteiro para uma estrutura MMC_TASK_DISPLAY_OBJECT que o snap-in deve preencher para especificar a imagem a ser exibida como a tela de fundo do bloco de tarefas especificado por pszGroup.
Lembre-se de que o chamador (MMC) aloca a memória para a estrutura MMC_TASK_DISPLAY_OBJECT.
Valor retornado
Esse método pode retornar um desses valores.
Comentários
Aloque as cadeias de caracteres na estrutura MMC_TASK_DISPLAY_BITMAP ou MMC_TASK_DISPLAY_SYMBOL especificada no parâmetro pTDO com a função de API COM CoTaskMemAlloc (ou o equivalente) e o MMC a liberará.
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | mmc.h |