MSVM _ GuestServiceInterfaceComponent :: RequestStateChange, méthode

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 [ dans]

Type : UInt16

Nouvel état. Les informations sont placées dans la propriété RequestedState de l’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 de 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)

Différer (8)

Suspension (9)

Redémarrer (10)

Réinitialiser (11)

DMTF réservé (..)

Fournisseur réservé (32768.. 65535)

Travail [ à]

Type : CIM _ ConcreteJob

Référence facultative à un objet _ ConcreteJob MSVM qui est retourné si l’opération est exécutée de façon 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 [ dans]

Type : DateTime

Délai d’attente 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 le délai d’attente. La valeur 0 ou null indique que le client n’a aucune exigence 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 (utilisation du paramètre timeout non pris en charge) doit être retourné.

Valeur retournée

Type : UInt32

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

Code/valeur de retour Description
Terminé sans erreur
0
Réussite.
Non pris en charge
1
Erreur 2 inconnue/non spécifiée
Impossible de se terminer dans le délai d’expiration
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 timeout non prise en charge
4098
Occupé
4099
Méthode réservée
4100.. 32767
32 768.. 65535
spécifiques au fournisseur

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 8.1 les [ applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2012 [Applications de bureau R2 uniquement]
Espace de noms
\\\Virtualisation racine \ v2
MOF
WindowsVirtualization. v2. mof
DLL
Vmms.exe

Voir aussi

MSVM _ GuestServiceInterfaceComponent