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

Artigo
07/16/2024

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

Compartilhar via