Compartir a través de

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

  • Artículo

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