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

  • Article

[[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 .] ]

Envoie une demande au service Planificateur de tâches pour exécuter l’élément de travail.

Syntaxe

HRESULT Run();

Valeur de retour

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

Code de retour Description
S_OK
 L'opération a réussi. La demande a été envoyée. Pour plus d'informations, consultez la section Notes.
E_INVALIDARG
 Les arguments ne sont pas valides.
E_OUTOFMEMORY
 Mémoire disponible insuffisante.

Remarques

L’exécution est une opération asynchrone. Un code de retour de S_OK signifie que la demande d’exécution de l’élément de travail a été effectuée ; cela ne signifie pas que l’élément de travail a commencé à s’exécuter. Il peut y avoir un délai de quelques secondes après le retour de l’exécution de l’élément de travail avant que l’élément de travail commence réellement à s’exécuter.

Pour déterminer si l’élément de travail est en cours d’exécution, appelez IScheduledWorkItem ::GetStatus.

Exemples

Pour obtenir un exemple de démarrage d’une tâche, consultez Démarrage d’un exemple de tâche.

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

Voir aussi

IScheduledWorkItem

IScheduledWorkItem ::GetStatus

Itask