Méthode IScheduledWorkItem ::CreateTrigger (mstask.h)

Article
03/04/2024

[[Cette API peut être modifiée ou indisponible dans les versions ultérieures du système d’exploitation ou du produit. Utilisez plutôt les interfaces Du planificateur de tâches 2.0 .] ]

Crée un déclencheur pour l’élément de travail.

Syntaxe

HRESULT CreateTrigger(
  [out] WORD         *piNewTrigger,
  [out] ITaskTrigger **ppTrigger
);

Paramètres

[out] piNewTrigger

Pointeur vers la valeur d’index de déclencheur retournée du nouveau déclencheur. L’index de déclencheur du premier déclencheur associé à un élément de travail est « 0 ». Consultez Les remarques pour d’autres utilisations de l’index de déclencheur.

[out] ppTrigger

Pointeur vers un pointeur vers une interface ITaskTrigger . Actuellement, les seuls éléments de travail pris en charge sont les tâches.

Valeur retournée

La méthode CreateTrigger retourne l’une des valeurs suivantes.

Code de retour	Description
S_OK	L'opération a réussi.
E_INVALIDARG	Les arguments ne sont pas valides.
E_OUTOFMEMORY	Mémoire disponible insuffisante.

Remarques

Vous utilisez l’index de déclencheur retourné par piNewTrigger lorsque vous récupérez ou supprimez des déclencheurs. Toutefois, l’index de déclencheur n’est pas un identificateur. Elle indique uniquement la position du nouveau déclencheur par rapport aux autres déclencheurs actuels associés à l’élément de travail.

Pour définir les critères du nouveau déclencheur, appelez ITaskTrigger ::SetTrigger.

Après avoir créé un déclencheur pour un élément de travail, les applications doivent appeler la méthode IPersistFile ::Save pour enregistrer le nouveau déclencheur sur le disque.

Exemples

Pour obtenir un exemple de définition des critères de déclencheur lors de la création d’un déclencheur, consultez Création d’un déclencheur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mstask.h
Bibliothèque	Mstask.lib
DLL	Mstask.dll
Composant redistribuable	Internet Explorer 4.0 ou version ultérieure sur Windows NT 4.0 et Windows 95