IVMGuestOS::Restart, méthode
[Windows Virtual PC n’est plus disponible à partir de Windows 8. Utilisez plutôt le fournisseur WMI Hyper-V (V2).]
Redémarre le système d’exploitation invité.
Syntaxe
HRESULT Restart(
[in] VARIANT_BOOL inForced,
[out, retval] IVMTask **outRestartTask
);
Paramètres
-
inForced [in]
-
VARIANT_TRUE si un redémarrage forcé est requis et VARIANT_FALSE sinon.
-
outRestartTask [out, retval]
-
Objet IVMTask utilisé pour suivre la progression de l’achèvement de la séquence de redémarrage.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code/valeur de retour | Description |
|---|---|
|
L'opération a réussi. |
|
Le paramètre outRestartTask est NULL. |
|
Une erreur inattendue s’est produite. |
|
L’opération ne s’est pas terminée en temps opportun. |
|
La machine virtuelle doit être en cours d’exécution pour cette opération. |
|
La configuration est inconnue. |
|
La fonctionnalité des composants d’intégration n’est pas installée dans cette machine virtuelle. |
Notes
Les valeurs suivantes peuvent être retournées via la propriété Error de l’objet IVMTask retourné.
| Code d’erreur /Valeur | Description |
|---|---|
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) (0x80070005) |
L’appelant doit disposer des autorisations d’accès d’exécution pour cette machine virtuelle. |
HRESULT_FROM_WIN32(ERROR_MACHINE_LOCKED) (0x800704f7) |
L’ordinateur est verrouillé et ne peut pas être arrêté sans l’option force. |
HRESULT_FROM_WIN32(ERROR_NOT_READY) (0x80070015) |
Le périphérique n’est pas prêt. |
HRESULT_FROM_WIN32(ERROR_SHUTDOWN_IN_PROGRESS) (0x8007045b) |
Un arrêt du système est en cours. |
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Aucun pris en charge |
| Fin de la prise en charge des clients |
Windows 7 |
| Produit |
Windows Virtual PC |
| En-tête |
|
| IID |
IID_IVMGuestOS est défini comme 99fea0db-4880-499a-b6d8-73dff9bc91be |