IVMGuestOS::Shutdown, méthode

Article
06/13/2023

[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

Partager via