Méthode RequestStateChange de la classe CIM_EnabledLogicalElement

Article
06/13/2023

Demande que l’état de l’élément soit remplacé par la valeur spécifiée dans le paramètre RequestedState. Lorsque le changement d’état demandé a lieu, EnabledState et RequestedState de l’élément sont identiques. L’appel de la méthode RequestStateChange plusieurs fois peut entraîner le remplacement ou la perte de requêtes antérieures.

Syntaxe

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

Paramètres

RequestedState [in]: État demandé pour l’élément . Ces informations sont placées dans la propriété RequestedState de l’instance si le code de retour de la méthode RequestStateChange est 0 (« Terminé sans erreur ») ou 4096 (0x1000) (« Travail démarré »). Reportez-vous à la description des propriétés EnabledState et RequestedState pour obtenir des explications détaillées sur les valeurs RequestedState .
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, enregistre les données, conserve l’état et arrête 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 Reserved (7..32767)
Fournisseur réservé (32768..65535)

Travail [out]

Peut contenir une référence aux CIM_ConcreteJob créées pour suivre la transition d’état initiée par l’appel de méthode.

TimeoutPeriod [in]

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

Retourne un 0 en cas de réussite ; sinon, retourne une erreur.

Terminé avec aucune erreur (0)
Non pris en charge (1)
Erreur inconnue ou 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 (..)
Paramètres de méthode vérifiés - Travail démarré (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
Serveur minimal pris en charge	Windows Server 2012 R2
Espace de noms	Root\virtualization\v2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Voir aussi

CIM_EnabledLogicalElement

Partager via