Método ITaskService::NewTask (taskschd.h)

Artigo
07/16/2024

Retorna um objeto de definição de tarefa vazio a ser preenchido com configurações e propriedades e, em seguida, registrado usando o método ITaskFolder::RegisterTaskDefinition.

Sintaxe

HRESULT NewTask(
  [in]  DWORD           flags,
  [out] ITaskDefinition **ppDefinition
);

Parâmetros

[in] flags

Esse parâmetro é reservado para uso futuro e deve ser definido como 0.

[out] ppDefinition

A definição de tarefa que especifica todas as informações necessárias para criar uma nova tarefa.

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

O ponteiro de ITaskDefinition retornado deve ser liberado depois de usado.

Valor de retorno

Esse método pode retornar um desses valores.

Código/valor de retorno	Descrição
S_OK 0x0	O método retornou com êxito sem erros.
E_POINTER 0x80004003	NULL foi passado para o parâmetro ppDefinition . Passe uma referência a um ponteiro de interfaceNULL ITaskDefinition.
E_INVALIDARG 0x80070057	Um valor diferente de zero foi passado para os sinalizadores parâmetro.

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

ITaskService

Compartilhar via