estrutura MMC_TASK (mmc.h)

Artigo
08/24/2023

A estrutura MMC_TASK é introduzida no MMC 1.1.

A estrutura MMC_TASK é preenchida pelo método IEnumTASK::Next para especificar todos os dados necessários para configurar uma tarefa individual em um bloco de tarefas.

Sintaxe

typedef struct _MMC_TASK {
  MMC_TASK_DISPLAY_OBJECT sDisplayObject;
  LPOLESTR                szText;
  LPOLESTR                szHelpString;
  MMC_ACTION_TYPE         eActionType;
  union {
    LONG_PTR nCommandID;
    LPOLESTR szActionURL;
    LPOLESTR szScript;
  };
} MMC_TASK;

Membros

sDisplayObject

MMC_TASK_DISPLAY_OBJECT estrutura que o snap-in deve preencher para especificar a imagem a ser exibida como a imagem da tarefa no bloco de tarefas especificado por pszGroup.

szText

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o texto colocado diretamente à direita da imagem sobre o mouse. Esse texto serve como o rótulo da tarefa. Esse texto deve ser uma ação no imperativo, como "Adicionar um novo usuário".

szHelpString

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o texto descritivo colocado no canto superior direito quando o usuário move o mouse sobre a imagem sobre o mouse ou o texto do rótulo da tarefa. Esse texto serve como a descrição da tarefa, como "Cria uma nova conta, cria uma caixa de correio e configura tudo o que um usuário deve acessar a rede".

eActionType

Valor do tipo MMC_ACTION_TYPE que especifica o tipo de ação disparada quando um usuário clica em uma tarefa em um bloco de tarefas.

Há três tipos de ações:

MMC_ACTION_ID

Quando o usuário clica na tarefa, o MMC chama IExtendTaskPad::TaskNotify e retorna a ID de comando especificada no membro nCommandID . Se você especificar esse valor, o membro nCommandID será necessário.

MMC_ACTION_LINK

Quando o usuário clica na tarefa, o MMC ativa o link especificado por szActionURL. Se você especificar esse valor, o membro szActionURL será necessário.

MMC_ACTION_SCRIPT

Quando o usuário clica na tarefa, o MMC executa o script contido em szScript usando o método window.execScript na página DHTML do painel de tarefas. Se você especificar esse valor, o membro zScript será necessário.

nCommandID

Usado somente se eActionType for MMC_ACTION_ID.

Um valor que especifica a ID de comando retornada ao snap-in quando o usuário clica na tarefa.

Quando o MMC chama IExtendTaskPad::TaskNotify, ele passa no parâmetro arg uma estrutura VARIANT que contém a ID de comando da tarefa que foi clicada no bloco de tarefas. O campo vt é VT_I4 e o campo lVal contém a ID do comando.

szActionURL

Usado somente se eActionType for MMC_ACTION_LINK.

[out] Um ponteiro para uma cadeia de caracteres terminada em nulo que contém a URL à qual a tarefa é vinculada. A URL deve ser totalmente qualificada. A cadeia de caracteres também pode conter um script em vez de uma URL.

szScript

Usado somente se eActionType for MMC_ACTION_SCRIPT.

[out] Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o script a ser executado usando o método window.execScript na página DHTML do bloco de tarefas. Para especificar o idioma do script, inicie a cadeia de caracteres com a linguagem de script:

"VBSCRIPT:"
"JSCRIPT:"
"JAVASCRIPT:"

Se nenhum idioma de script for especificado, o idioma padrão será JavaScript.

Comentários

Aloque as cadeias de caracteres szText, szHelpString, szActionURL e szScript usadas na estrutura com a função de API COM CoTaskMemAlloc (ou equivalente) e o MMC as liberará.

Você também deve alocar as cadeias de caracteres no MMC_TASK_DISPLAY_BITMAP ou MMC_TASK_DISPLAY_SYMBOL estrutura especificada no membro sDisplayObject com CoTaskMemAlloc (ou o equivalente) e o MMC as liberará.