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 NULLITaskDefinition. Hacer referencia a un puntero que no es NULL puede provocar una pérdida de memoria porque el puntero se sobrescribirá.

El puntero ITaskDefinition devuelto debe liberarse después de usarlo.

Valor devuelto

Este método puede devolver uno de estos valores.

Código y valor devueltos	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 NULLITaskDefinition.
E_INVALIDARG 0x80070057	Se pasó un valor distinto de cero a las marcas de parámetro.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	taskschd.h
biblioteca de	Taskschd.lib
DLL de	Taskschd.dll

Consulte también

ITaskService