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

Article
07/16/2024

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

Partager via