Méthode RequestStateChange de la classe CIM_ConcreteJob

Article
06/13/2023

Demande que l’état du travail soit remplacé par la valeur spécifiée dans le paramètre RequestedState. L’appel de la méthode RequestStateChange plusieurs fois peut entraîner le remplacement ou la perte de requêtes antérieures.

Si 0 est retourné, la tâche s’est terminée avec succès. Tout autre code de retour indique une condition d’erreur.

Syntaxe

uint32 RequestStateChange(
  [in] uint16   RequestedState,
  [in] datetime TimeoutPeriod
);

Paramètres

RequestedState [in]: État à demander pour un travail. Les valeurs possibles sont les suivantes :
Démarrer (2): Remplace l’état par « En cours d’exécution ».
Suspendre (3): Arrête temporairement le travail. L’intention est de redémarrer ensuite le travail avec « Démarrer ». Il peut être possible d’entrer l’état « Service » pendant la suspension. (Il s’agit d’un travail spécifique.)
Terminer (4): Arrête le travail proprement, enregistre les données, conserve l’état et arrête tous les processus sous-jacents de manière ordonnée.
Tuer (5): Termine immédiatement le travail sans qu’il soit nécessaire d’enregistrer les données ou de préserver l’état.
Service (6): Place le travail dans un état de service spécifique au fournisseur. Il peut être possible de redémarrer le travail.
DMTF Réservé (7.32767)
Fournisseur réservé (32768..65535)

TimeoutPeriod [in]

Délai d’expiration qui spécifie la durée maximale pendant laquelle le client attend la transition vers le nouvel état. Le format d’intervalle doit être utilisé pour spécifier la période de délai d’expiration. La valeur 0 ou Null indique que le client n’a pas besoin de temps pour la transition. Si cette propriété ne contient pas 0 ou Null et que l’implémentation ne prend pas en charge ce paramètre, un code de retour de 4098 (Use Of Timeout Parameter Not Supported) doit être retourné.

Valeur retournée

Retourne un 0 en cas de réussite ; sinon, retourne une erreur.

Terminé avec aucune erreur (0)
Non pris en charge (1)
Erreur inconnue/non spécifiée (2)
Impossible de terminer dans la période de délai d’attente (3)
Échec (4)
Paramètre non valide (5)
En cours d’utilisation (6)
DMTF réservé (..)
Paramètres de méthode vérifiés - Transition démarrée (4096)
Transition d’état non valide (4097)
Utilisation du paramètre de délai d’expiration non pris en charge (4098)
Occupé (4099)
Méthode réservée (4100..32767)
Fournisseur spécifique (32768..65535)

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1
Serveur minimal pris en charge	Windows Server 2012 R2
Espace de noms	Racine\virtualisation\v2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Voir aussi

CIM_ConcreteJob

Partager via