Msvm_GuestServiceInterfaceComponent::RequestStateChange, méthode

Article
06/13/2023

Demande que l’état du composant d’interface de 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]

Type : uint16

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]

Type : CIM_ConcreteJob

Référence facultative à un objet Msvm_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]

Type : datetime

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

Type : uint32

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
Erreur inconnue/non spécifiée 2
Impossible de se 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
Spécifique au fournisseur 32768..65535

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_GuestServiceInterfaceComponent

Partager via