Méthode RequestStateChange de la classe Msvm_ConcreteJob

Article
06/13/2023

Demande que l’état du travail soit remplacé par l’état spécifié. 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]

Type : uint16

Nouvel état d’un travail.

Début (2)

Remplace l’état par « En cours d’exécution ».

Suspendre (3)

Arrête temporairement le travail. L’intention est de redémarrer le travail par la suite 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, en enregistrant les données, en conservant l’état et en arrêtant 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 des données ou de conserver 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é

Réservé.

Fournisseur réservé

Réservé.

TimeoutPeriod [in]

Type : datetime

Délai d’expiration qui spécifie la durée maximale pendant laquelle le client s’attend à ce que la transition vers le nouvel état prenne. Le format d’intervalle doit être utilisé pour spécifier le 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 4098 (Use Of Timeout Parameter Not Supported) doit être retourné.

Valeur retournée

Type : uint32

Cette méthode retourne l’une des valeurs suivantes.

Terminé avec aucune erreur (0)
Non pris en charge (1)
Erreur inconnue/non spécifiée (2)
Impossible de se terminer dans le délai d’expiration (3)
Échec (4)
Paramètre non valide (5)
En cours d’utilisation (6)
DMTF Reserved (7 4095)
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)
Spécifique au fournisseur (32768 65535)

Notes

L’accès à la classe Msvm_ConcreteJob peut être limité par le filtrage UAC. Pour plus d’informations, consultez Contrôle de compte d’utilisateur et WMI.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Espace de noms	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Voir aussi

Msvm_ConcreteJob

Partager via