Partager via

ITaskService ::NewTask, méthode (taskschd.h)

  • Article

Retourne un objet de définition de tâche vide à remplir avec les paramètres et les propriétés, puis inscrit à l’aide de la méthode ITaskFolder ::RegisterTaskDefinition.

Syntaxe

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

Paramètres

[in] flags

Ce paramètre est réservé pour une utilisation ultérieure et doit être défini sur 0.

[out] ppDefinition

Définition de tâche qui spécifie toutes les informations requises pour créer une tâche.

Transmettez une référence à un pointeur d’interface NULLITaskDefinition. Le référencement d’un pointeur non NULL peut provoquer une fuite de mémoire, car le pointeur sera remplacé.

Le pointeur ITaskDefinition retourné doit être libéré une fois qu’il est utilisé.

Valeur de retour

Cette méthode peut retourner l’une de ces valeurs.

Retourner le code/la valeur Description
S_OK
0x0
 La méthode a été retournée correctement sans erreur.
E_POINTER
0x80004003
 NULL a été passé au paramètre ppDefinition. Transmettez une référence à un pointeur d’interface NULLITaskDefinition.
E_INVALIDARG
0x80070057
 Une valeur différente de zéro a été passée dans les indicateurs paramètre.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2008 [applications de bureau uniquement]
plateforme cible Windows
d’en-tête taskschd.h
bibliothèque Taskschd.lib
DLL Taskschd.dll

Voir aussi

ITaskService