Partager via


ITaskHandler ::Start, méthode (taskschd.h)

Appelé pour démarrer le gestionnaire COM. Cette méthode doit être implémentée par le gestionnaire.

Syntaxe

HRESULT Start(
  [in] IUnknown *pHandlerServices,
  [in] BSTR     data
);

Paramètres

[in] pHandlerServices

Interface IUnkown utilisée pour communiquer avec le planificateur de tâches.

[in] data

Arguments requis par le gestionnaire. Ces arguments sont définis dans la propriété Data de l’action de gestionnaire COM.

Valeur retournée

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

Remarques

Lors de l’implémentation de cette méthode, le gestionnaire doit retourner immédiatement le contrôle au planificateur de tâches (en commençant son propre thread si inproc).

Une fois que le gestionnaire a démarré son traitement, il peut appeler la méthode UpdateStatus pour indiquer son pourcentage d’achèvement ou appeler la méthode TaskCompleted pour indiquer quand le gestionnaire a terminé son traitement. Ces méthodes sont fournies par l’interface ITaskHandlerStatus .

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

Données

ITaskHandler

ITaskHandlerStatus

Planificateur de tâches

TaskCompleted

UpdateStatus