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

Devuelve un objeto de definición de tarea vacío que se rellenará con la configuración y las propiedades y, a continuación, se registrará mediante el método ITaskFolder::RegisterTaskDefinition .

Sintaxis

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

Parámetros

[in] flags

Este parámetro está reservado para uso futuro y debe establecerse en 0.

[out] ppDefinition

Definición de tarea que especifica toda la información necesaria para crear una nueva tarea.

Pase una referencia a un puntero de interfaz ITaskDefinitionNULL. Hacer referencia a un puntero distinto de NULL puede provocar una pérdida de memoria porque el puntero se sobrescribirá.

El puntero ITaskDefinition devuelto debe liberarse después de su uso.

Valor devuelto

Este método puede devolver uno de estos valores.

Código o valor devuelto	Descripción
S_OK 0x0	El método devolvió correctamente sin error.
E_POINTER 0x80004003	NULL se pasó al parámetro ppDefinition . Pase una referencia a un puntero de interfaz ITaskDefinitionNULL.
E_INVALIDARG 0x80070057	Se pasó un valor distinto de cero al parámetro flags .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	taskschd.h
Library	Taskschd.lib
Archivo DLL	Taskschd.dll

Consulte también

ITaskService