IVMVirtualMachine::Save, méthode

Article
06/13/2023

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

Enregistre l’état de la machine virtuelle.

Syntaxe

HRESULT Save(
  [out, retval] IVMTask **saveTask
);

Paramètres

saveTask [out, retval]: Objet IVMTask utilisé pour suivre la progression de l’achèvement de la séquence d’enregistrement d’état de la machine virtuelle.

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_FAIL 0x80004005	La machine virtuelle n’a pas pu être enregistrée, car les disques d’annulation ont été marqués pour suppression.
E_POINTER 0x80004003	Le paramètre est NULL.
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) 0x80070005	L’appelant doit disposer des autorisations d’accès d’exécution pour enregistrer l’état de cette machine virtuelle.
VM_E_VM_NOT_RUNNING 0xA0040206	La machine virtuelle n’est pas en cours d’exécution.
DISP_E_EXCEPTION 0x80020009	Une erreur inattendue s’est produite.

Notes

La machine virtuelle est désactivée lorsque la tâche Enregistrer est terminée. La propriété IVMVirtualMachine::State contient vmVMState_Saving pendant que l’enregistrement est en cours, suivi de vmVMState_Saved lorsque l’enregistrement est terminé et que la machine virtuelle est désactivée.

Configuration requise

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_IVMVirtualMachine est défini comme f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Voir aussi

IVMVirtualMachine

Partager via