Partager via

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

  • Article

Retourne un objet de définition de tâche vide à remplir avec des paramètres et des propriétés, puis à inscrire à 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 ITaskDefinitionNULL. Le référencement d’un pointeur non NULL peut entraîner une fuite de mémoire, car le pointeur sera remplacé.

Le pointeur ITaskDefinition retourné doit être libéré après son utilisation.

Valeur retournée

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

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête taskschd.h
Bibliothèque Taskschd.lib
DLL Taskschd.dll

Voir aussi

ITaskService