Msvm_CopyFileToGuestJob::RequestStateChange, méthode

Article
06/13/2023

Modifie l’état du travail.

Syntaxe

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

Paramètres

RequestedState [in]: Nouvel état. Voici les valeurs possibles :
Démarrer (2): Remplace l’état par « En cours d’exécution ».
Suspendre (3): Arrête temporairement le travail. Le client peut ensuite redémarrer le travail avec « Démarrer ». Le client peut éventuellement entrer l’état « Service » lors de sa suspension (il s’agit d’un travail spécifique).
Terminer (4): Arrête le travail proprement, en enregistrant les données, en préservant 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 les données ou de préserver l’état.
Service (6): Place le travail dans un état de service spécifique au fournisseur. Le client peut éventuellement 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

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

Code/valeur de retour	Description
Terminé avec aucune erreur 0	Réussite.
Utilisation du paramètre de délai d’expiration non pris en charge 4098
Échec 32 768
accès refusé 32769	Accès refusé.
Non pris en charge 32770
L’état est inconnu 32771
Délai d'expiration 32772
Paramètre non valide 32773
Le système est en cours d’utilisation 32774
État non valide pour cette opération 32775	La valeur spécifiée dans le paramètre RequestedState n’est pas prise en charge.
Type de données incorrect 32776
Le système n’est pas disponible 32777
Mémoire insuffisante 32778

Spécifications

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

Voir aussi

Msvm_CopyFileToGuestJob

Partager via