MSVM _ CopyFileToGuestJob :: RequestStateChange, méthode

Modifie l’état de la tâche.

Syntaxe

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

Paramètres

RequestedState [ dans]

Nouvel état. Les valeurs possibles sont les suivantes :

Démarrer (2)

Modifie l’État en’Running'.

Suspendre (3)

Arrête temporairement le travail. Le client peut ensuite redémarrer le travail avec « Start ». Le client peut éventuellement entrer l’État « service » en suspens (ce qui est spécifique à un travail).

Terminer (4)

Arrête le travail proprement dit, en enregistrant les données, en conservant l’État et en arrêtant 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. Le client peut éventuellement redémarrer le travail.

DMTF réservé (7.. 32767)

Fournisseur réservé (32768.. 65535)

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

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

Code/valeur de retour Description
Terminé sans erreur
0
Réussite.
Utilisation du paramètre timeout non prise en charge
4098
Échec
32768
Accès refusé
32769
Accès refusé.
Non pris en charge
32770
L'
État est inconnu
32771
Délai d’expiration
32772
Paramètre non valide
32773
Le
système est en cours d’utilisation
32774
État non valide pour cette opération
32775
La valeur spécifiée dans le paramètre RequestedState n’est pas prise en charge.
Type de données incorrect
32776
Le
système n’est pas disponible
32777
Mémoire Insuffisante
32778

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 _ CopyFileToGuestJob