Compartilhar via

Método IActionCollection::Create (taskschd.h)

Cria e adiciona uma nova ação à coleção.

Sintaxe

HRESULT Create(
  [in]  TASK_ACTION_TYPE type,
  [out] IAction          **ppAction
);

Parâmetros

[in] type

Esse parâmetro é definido como uma das seguintes constantes de enumeração TASK_ACTION_TYPE.

Valor Significado
TASK_ACTION_EXEC
0
 A ação executa uma operação de linha de comando. Por exemplo, a ação pode executar um script, iniciar um executável ou, se o nome de um documento for fornecido, localizar seu aplicativo associado e iniciar o aplicativo com o documento.
TASK_ACTION_COM_HANDLER
5
 A ação aciona um manipulador.
TASK_ACTION_SEND_EMAIL
6
 Essa ação envia uma mensagem de email.
TASK_ACTION_SHOW_MESSAGE
7
 Esta ação mostra uma caixa de mensagem.

[out] ppAction

Uma interface do IAction que representa a nova ação.

Passe uma referência a um ponteiro de interface NULLIAction. Fazer referência a um ponteiro NULL nãopode causar um vazamento de memória porque o ponteiro será substituído.

Valor de retorno

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Observações

Não é possível adicionar mais de 32 ações à coleção.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho taskschd.h
biblioteca Taskschd.lib
de DLL Taskschd.dll

Consulte também

do IAction

IActionCollection

IComHandlerAction

IEmailAction

IExecAction

IShowMessageAction

TASK_ACTION_TYPE

do Agendador de Tarefas

  • Last updated on