IActionCollection ::Create, méthode (taskschd.h)

Crée et ajoute une nouvelle action à la collection.

Syntaxe

HRESULT Create(
  [in]  TASK_ACTION_TYPE type,
  [out] IAction          **ppAction
);

Paramètres

[in] type

Ce paramètre est défini sur l’une des constantes d’énumération TASK_ACTION_TYPE suivantes.

Valeur	Signification
TASK_ACTION_EXEC 0	L’action effectue une opération de ligne de commande. Par exemple, l’action peut exécuter un script, démarrer un exécutable ou, si le nom d’un document est fourni, rechercher son application associée et démarrer l’application avec le document.
TASK_ACTION_COM_HANDLER 5	L’action déclenche un gestionnaire.
TASK_ACTION_SEND_EMAIL 6	Cette action envoie un e-mail.
TASK_ACTION_SHOW_MESSAGE 7	Cette action affiche une boîte de message.

[out] ppAction

Interface IAction qui représente la nouvelle action.

Passez une référence à un pointeur d’interface NULLIAction. Le référencement d’un pointeur NULL nonpeut provoquer une fuite de mémoire, car le pointeur sera remplacé.

Valeur de retour

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un HRESULT code d’erreur.

Remarques

Vous ne pouvez pas ajouter plus de 32 actions à la collection.

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

IAction

IActionCollection

IComHandlerAction

IEmailAction

IExecAction

IShowMessageAction

TASK_ACTION_TYPE

planificateur de tâches