Créer une méthode de la _ classe ScheduledJob Win32

La méthode Create WMI Class soumet un travail à un système d’exploitation pour une exécution à une date et une heure spécifiées à l’avenir. Cette méthode nécessite que le service de planification soit démarré sur l’ordinateur sur lequel le travail est envoyé.

Cette rubrique utilise la syntaxe format MOF (MOF). Pour plus d’informations sur l’utilisation de cette méthode, consultez appel d’une méthode.

Syntaxe

uint32 Create(
  [in]           string   Command,
  [in]           datetime StartTime,
  [in, optional] boolean  RunRepeatedly,
  [in, optional] uint32   DaysOfWeek,
  [in, optional] uint32   DaysOfMonth,
  [in, optional] boolean  InteractWithDesktop,
  [out]          uint32   JobId
);

Paramètres

Commande [ dans]

Nom de la commande, du programme de traitement par lots ou du fichier binaire et des paramètres de ligne de commande que le service de planification utilise pour appeler le travail.

Exemple : « Defrag/q/f ».

StartTime [ dans]

Temps universel coordonné (UTC) pour exécuter un travail. Le formulaire doit être : «AAAAMMJJHHMMSS. MMMMMM (+-) OOO», où « AAAAMMJJ » doit être remplacé par « * * * * * * * * ». Par exemple : « * * * * * * * * 143000.000000-420 » spécifie 14,30 (2:30 P.M.) PST avec l’heure d’été en vigueur.

La section « (+-) OOO » de la valeur de la propriété StartTime est le décalage actuel pour la traduction de l’heure locale. Le biais correspond à la différence entre l’heure UTC et l’heure locale. Pour calculer le décalage pour votre fuseau horaire, multipliez le nombre d’heures d’avance ou de retard de l’heure de Greenwich (GMT) par 60 (utilisez un nombre positif comme nombre d’heures avant l’heure GMT et un nombre négatif si votre fuseau horaire est situé en arrière-plan GMT). Ajoutez un 60 supplémentaire à votre calcul si votre fuseau horaire utilise l’heure d’été. Par exemple, le fuseau horaire Pacifique est de huit heures après l’heure GMT. par conséquent, le décalage est égal à-420 (-8 * 60 + 60) lorsque l’heure d’été est utilisée et-480 (-8 * 60) lorsque l’heure d’été n’est pas utilisée. Vous pouvez également déterminer la valeur du décalage en interrogeant la propriété Bias de la classe Win32 _ TimeZone .

RunRepeatedly [ dans, facultatif]

Si la valeur est true, une tâche planifiée s’exécute de manière répétée sur des jours spécifiques. La valeur par défaut est False.

DaysOfWeek [ dans, facultatif]

Jours de la semaine où un travail est planifié pour s’exécuter ; utilisé uniquement lorsque le paramètre RunRepeatedly a la valeur true. Pour planifier un travail depuis plus d’un jour de la semaine, joignez les valeurs appropriées dans un ou logique. Par exemple, pour planifier un travail pour les mardis et les vendredis, la valeur de DaysOfWeek est 2 ou 16.

Lundi (1)

Mardi (2)

Mercredi (4)

Jeudi (8)

Vendredi (16)

Samedi (32)

Dimanche (64)

DaysOfMonth [ dans, facultatif]

Jours du mois où un travail est planifié pour s’exécuter ; utilisé uniquement lorsque le paramètre RunRepeatedly a la valeur true.

1 (1)

Jour 1 d’un mois

2 (2)

Jour 2 du mois

3 (4)

Jour 3 du mois

4 (8)

Jour 4 d’un mois

5 (16)

Jour 5 du mois

6 (32)

Jour 6 du mois

7 (64)

Jour 7 du mois

8 (128)

Jour 8 d’un mois

9 (256)

Jour 9 du mois

10 (512)

Jour 10 d’un mois

11 (1024)

Jour 11 du mois

12 (2048)

Jour 12 du mois

13 (4096)

Jour 13 du mois

14 (8192)

Jour 14 du mois

15 (16384)

Jour 15 d’un mois

16 (32768)

Jour 16 du mois

17 (65536)

Jour 17 d’un mois

18 (131072)

Jour 18 du mois

19 (262144)

Jour 19 du mois

20 (524288)

Jour 20 du mois

21 (1048576)

Jour 21 du mois

22 (2097152)

Jour 22 du mois

23 (4194304)

Jour 23 du mois

24 (8388608)

Jour 24 du mois

25 (16777216)

Jour 25 du mois

26 (33554432)

Jour 26 du mois

27 (67108864)

Jour 27 du mois

28 (134217728)

Jour 28 du mois

29 (268435456)

Jour 29 du mois

30 (536870912)

Jour 30 du mois

31 (1073741824)

Jour 31 du mois

InteractWithDesktop [ dans, facultatif]

Si la valeur est true, le travail spécifié doit être interactif, ce qui signifie qu’un utilisateur peut fournir une entrée à une tâche planifiée pendant l’exécution du travail. La valeur par défaut est False.

JobID [ à]

Numéro d’identification d’un travail. Ce paramètre est un handle vers une tâche planifiée sur un ordinateur.

Valeur retournée

Retourne la valeur 0 (zéro) en cas de réussite et un autre nombre pour indiquer une erreur. Pour obtenir d’autres codes d’erreur, consultez constantes d’erreur WMI ou WbemErrorEnum. Pour obtenir les valeurs de HRESULT générales, consultez codes d’erreur système.

Opération réussie

0

La demande est acceptée.

Non pris en charge

1

La demande n'est pas prise en charge.

Accès refusé

2

L’utilisateur n’a pas l’accès nécessaire.

Échec inconnu

8

Processus interactif.

Chemin d'accès introuvable

9

Le chemin d’accès au répertoire du fichier exécutable du service est introuvable.

Paramètre non valide

21

Des paramètres non valides ont été transmis au service.

Service non démarré

22

Le compte sous lequel ce service s’exécute n’est pas valide ou ne dispose pas des autorisations nécessaires pour exécuter le service.

Autres

23 4294967295

Remarques

si votre tâche planifiée démarre un programme interactif comme Bloc-notes, la propriété InteractWithDeskto doit avoir la valeur True ou l’écran du programme n’est pas visible. Le processus apparaît toujours dans le Gestionnaire des tâches , même s’il n’apparaît pas à l’écran.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
Espace de noms
\Cimv2 racine
MOF
CIMWin32. mof
DLL
CIMWin32.dll

Voir aussi

Classes du système d’exploitation

_ScheduledJob Win32