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 |
|
| DLL |
|