Méthode IScheduledWorkItem ::Run (mstask.h)
[[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 |
|---|---|
|
L'opération a réussi. La demande a été envoyée. Pour plus d'informations, consultez la section Notes. |
|
Les arguments ne sont pas valides. |
|
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 |