Método IExtendTaskPad::GetDescriptiveText (mmc.h)
O método IExtendTaskPad::GetDescriptiveText permite que o MMC obtenha o texto descritivo do bloco de tarefas a ser exibido em blocos de tarefas que usam modelos de bloco de tarefas do MMC.
Sintaxe
HRESULT GetDescriptiveText(
[in] LPOLESTR pszGroup,
[out] LPOLESTR *pszDescriptiveText
);
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, szGroup será uma cadeia de caracteres NULL .
[out] pszDescriptiveText
Um ponteiro para o endereço de uma cadeia de caracteres terminada em nulo que contém o texto descritivo para o bloco de tarefas especificado por pszGroup. Esse texto é exibido na parte superior do bloco de tarefas abaixo do título de todo o bloco de tarefas. Esse texto pode ser uma frase que serve como um subtítulo ou instruções (como "Clique em uma ação para executar").
Se pszDescriptiveText apontar para uma cadeia de caracteres NULL , nenhum texto descritivo será exibido.
Retornar valor
Esse método pode retornar um desses valores.
Comentários
Aloque a cadeia de caracteres pszDescriptiveText com a função de API COM CoTaskMemAlloc (ou o equivalente) e o MMC a liberará.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | mmc.h |