IVMGuestOS::Shutdown, méthode

  • Article

[Windows Virtual PC n’est plus disponible depuis Windows 8. Utilisez plutôt le fournisseur WMI Hyper-V (V2).]

Arrête le système d’exploitation invité dans la machine virtuelle.

Syntaxe

HRESULT Shutdown(
  [in]          VARIANT_BOOL isForced,
  [out, retval] IVMTask      **outShutdownTask
);

Paramètres

isForced [in]

VARIANT_TRUE si l’arrêt doit être forcé, VARIANT_FALSE sinon.

outShutdownTask [out, retval]

Objet IVMTask utilisé pour suivre l’achèvement du processus d’arrêt.

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 outShutdownTask est NULL.
VM_E_TIMED_OUT
0xA0040202
 L’opération ne s’est pas terminée en temps opportun.
VM_E_VM_UNKNOWN
0xA0040207
 La machine virtuelle est introuvable.
VM_E_VM_NOT_RUNNING
0xA0040206
 La machine virtuelle doit être en cours d’exécution pour cette opération.
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED)
0x80070005
 L’appelant doit disposer d’autorisations d’accès d’exécution pour cette machine virtuelle.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 La fonctionnalité des composants d’intégration n’est pas installée dans cette machine virtuelle.
DISP_E_EXCEPTION
0x80020009
 Une erreur inattendue s’est produite.

Notes

La machine virtuelle doit être en cours d’exécution et la fonctionnalité composants d’intégration doit être installée lorsque cette méthode est appelée. Cette méthode est uniquement prise en charge pour les systèmes d’exploitation invités Windows.

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 d’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