Método IExtendTaskPad::TaskNotify (mmc.h)
O método IExtendTaskPad::TaskNotify permite que o MMC notifique o snap-in quando uma tarefa é estendida. Se o bloco de tarefas for um bloco de tarefas de exibição de lista, o MMC também chamará IExtendTaskPad::TaskNotify quando um botão de exibição de lista for estendido.
Sintaxe
HRESULT TaskNotify(
[in] IDataObject *pdo,
[in] VARIANT *arg,
[in] VARIANT *param
);
Parâmetros
[in] pdo
Um ponteiro para o objeto de dados do item de escopo que possui o bloco de tarefas. Se o snap-in possuir o item que exibe o bloco de tarefas, pdo será um ponteiro para esse item. Se o snap-in estiver estendendo o painel de tarefas de outro snap-in, pdo será um ponteiro para o item no snap-in que possui o bloco de tarefas.
[in] arg
Um ponteiro para uma estrutura VARIANT que contém informações passadas do controle CIC no bloco de tarefas.
Blocos de tarefas usando modelos de bloco de tarefas do MMC
Para os blocos de tarefas fornecidos pelo MMC, a estrutura VARIANT contém a ID de comando para a tarefa do bloco de tarefas ou o botão de exibição de lista que foi ed.
O campo vt é VT_I4 e o campo lVal contém a ID de comando para a tarefa do bloco de tarefas ou o botão de exibição de lista que foi ed. Os botões de exibição de lista se aplicam somente a blocos de tarefas de exibição de lista.
Uma ID de comando de tarefa é especificada no membro nCommandID da estrutura MMC_TASK , que é passada no método IEnumTASK::Next que o MMC chama quando recupera as informações dessa tarefa durante a instalação do bloco de tarefas.
Um botão de exibição de lista é o botão especificado no membro szButtonText da estrutura MMC_LISTPAD_INFO , que é passado no método IExtendTaskPad::GetListPadInfo que o MMC chama quando está configurando o bloco de tarefas de exibição de lista. A ID do comando do botão de exibição de lista é especificada no membro nCommandID do MMC_LISTPAD_INFO.
Blocos de tarefas usando páginas HTML personalizadas
Para blocos de tarefas personalizados, a estrutura VARIANT pode conter todos os dados que o script na página HTML personalizada deseja passar pelo método TaskNotify do objeto CIC
[in] param
Um ponteiro para uma estrutura VARIANT que contém informações passadas do controle CIC no bloco de tarefas.
Os blocos de tarefas que usam os modelos do bloco de tarefas do MMC ignoram esse parâmetro. No entanto, os blocos de tarefas personalizados podem usá-lo para passar um valor adicional de volta para o snap-in.
Valor retornado
Esse método pode retornar um desses valores.
Comentários
O snap-in pode identificar o item de escopo que possui o bloco de tarefas usando o ponteiro pdo; em seguida, ele pode identificar a tarefa pelo valor VARIANT retornado no parâmetro arg. Se o bloco de tarefas for um bloco de tarefas de exibição de lista, o snap-in poderá identificar o item selecionado (ou itens se houver suporte para várias seleções) em uma lista de resultados usando a interface IResultData . Com base nesses dados, o snap-in pode executar as ações apropriadas no objeto apropriado.
Se um botão de exibição de lista do bloco de tarefas for fornecido para um bloco de tarefas de exibição de lista, o snap-in poderá identificar o botão para o bloco de tarefas específico pelo valor VARIANT retornado no parâmetro arg.
Um bloco de tarefas personalizado pode passar todos os valores que ele determina que devem ser enviados nos parâmetros arg e param.
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | mmc.h |