Condividi tramite


Metodo ITaskService::NewTask (taskschd.h)

Restituisce un oggetto definizione di attività vuoto da compilare con impostazioni e proprietà e quindi registrato usando il metodo ITaskFolder::RegisterTaskDefinition .

Sintassi

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

Parametri

[in] flags

Questo parametro è riservato per l'uso futuro e deve essere impostato su 0.

[out] ppDefinition

Definizione dell'attività che specifica tutte le informazioni necessarie per creare una nuova attività.

Passare un riferimento a un puntatore dell'interfaccia ITaskDefinitionNULL. Il riferimento a un puntatore non NULL può causare una perdita di memoria perché il puntatore verrà sovrascritto.

Il puntatore ITaskDefinition restituito deve essere rilasciato dopo l'uso.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice/valore restituito Descrizione
S_OK
0x0
Il metodo restituito correttamente senza errore.
E_POINTER
0x80004003
NULL è stato passato al parametro ppDefinition . Passare un riferimento a un puntatore dell'interfaccia ITaskDefinitionNULL.
E_INVALIDARG
0x80070057
Un valore diverso da zero è stato passato al parametro flags .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione taskschd.h
Libreria Taskschd.lib
DLL Taskschd.dll

Vedi anche

ITaskService