Méthode RequestStateChange de la _ classe CIM EnabledLogicalElement

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

Syntaxe

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

Paramètres

RequestedState [ dans]

État demandé pour l’élément. Ces informations seront 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) ('Job Started'). Reportez-vous à la description des propriétés EnabledState et RequestedState pour obtenir des explications détaillées sur les valeurs de RequestedState .

Démarrer (2)

Modifie l’État en’Running'.

Suspendre (3)

Arrête temporairement le travail. L’objectif est de redémarrer ensuite le travail avec « Start ». Il peut être possible d’entrer dans l’État « service » en suspens. (Ceci est spécifique à un travail.)

Terminer (4)

Arrête le travail proprement dit, enregistre les données, conserve l’État et arrête tous les processus sous-jacents de manière ordonnée.

Kill (5)

Met immédiatement fin à la tâche, sans qu’il soit nécessaire d’enregistrer les 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 réservé (7.. 32767)

Fournisseur réservé (32768.. 65535)

Travail [ à]

Peut contenir une référence au _ ConcreteJob CIM créé pour effectuer le suivi de la transition d’État initiée par l’appel de méthode.

TimeoutPeriod [ dans]

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

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

Terminé sans erreur (0)

Non pris en charge (1)

Erreur inconnue ou non spécifiée (2)

Impossible de se terminer dans le délai imparti (3)

Échec (4)

Paramètre non valide (5)

En cours d’utilisation (6)

DMTF réservé (..)

Paramètres de méthode activés-tâche 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)

Spécifique au fournisseur (32768.. 65535)

Configuration requise

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

Voir aussi

_ENABLEDLOGICALELEMENT CIM