IVMGuestOS::Restart, méthode

  • Article

[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
S_OK
0
 L'opération a réussi.
E_POINTER
0x80004003
 Le paramètre outRestartTask est NULL.
DISP_E_EXCEPTION
0x80020009
 Une erreur inattendue s’est produite.
VM_E_TIMED_OUT
0xA0040202
 L’opération ne s’est pas terminée en temps opportun.
VM_E_VM_NOT_RUNNING
0xA0040206
 La machine virtuelle doit être en cours d’exécution pour cette opération.
VM_E_VM_UNKNOWN
0xA0040207
 La configuration est inconnue.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 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
VPCCOMInterfaces.h
IID
 IID_IVMGuestOS est défini comme 99fea0db-4880-499a-b6d8-73dff9bc91be

Voir aussi

IVMGuestOS