Msvm_GuestService::RequestStateChange, méthode

Article
06/13/2023

Demande que l’état du service invité soit remplacé par la valeur spécifiée.

Syntaxe

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

Paramètres

RequestedState [in]: Nouvel état. Les informations sont placées dans la propriété RequestedState du instance si le code de retour de la méthode RequestStateChange est 0 ou 4096. Pour plus d’informations, consultez la description des propriétés EnabledState et RequestedState pour l’élément. Il doit s’agir de l’une des valeurs suivantes.
Activé (2)
Désactivé (3)
Arrêter (4)
Hors connexion (6)
Test (7)
Report (8)
Quiesce (9)
Redémarrage (10)
Réinitialiser (11)
DMTF réservé (..)
Fournisseur réservé (32768..65535)

Travail [out]

Référence facultative à un objet CIM_ConcreteJob qui est retourné si l’opération est exécutée de manière asynchrone. Si elle est présente, la référence retournée peut être utilisée pour surveiller la progression et obtenir le résultat de la méthode.

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.
Non pris en charge 1
Paramètres de méthode vérifiés - Transition démarrée 4096	La transition est asynchrone.
Utilisation du paramètre de délai d’expiration non pris en charge 4098
accès refusé 32769	Accès refusé.
État non valide pour cette opération 32775	La valeur spécifiée dans le paramètre RequestedState n’est pas prise en charge.

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_GuestService

Partager via