IVMHardDisk::Convert, 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).]

Convertit un disque dur virtuel de taille fixe en disque dur virtuel à expansion dynamique ou convertit un disque dur virtuel à expansion dynamique en disque dur virtuel de taille fixe.

Syntaxe

HRESULT Convert(
  [in]          BSTR           convertedDiskImagePath,
  [in]          VMHardDiskType convertedDiskImageType,
  [out, retval] IVMTask        **convertTask
);

Paramètres

convertedDiskImagePath [in]: Chemin d’accès au fichier image de disque cible.
convertedDiskImageType [in]: Type de l’image de disque cible. Pour obtenir la liste des valeurs, consultez VMHardDiskType.
convertTask [out, retval]: Objet IVMTask utilisé pour suivre l’achèvement du processus de conversion.

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_INVALIDARG 0x80000003	Le paramètre convertedDiskImagePath est vide ou l’extension .vhd est manquante sur le nom de fichier.
E_POINTER 0x80004003	Un paramètre est NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	Le système ne peut pas trouver le chemin spécifié par le paramètre convertedDiskImagePath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Le paramètre convertedDiskImagePath contient un caractère non valide (l’un de « * ? »<> /\|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Le paramètre convertedDiskImagePath spécifie un chemin d’accès vide ou relatif. Un chemin d’accès absolu est requis.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Le chemin d’accès spécifié par le paramètre convertedDiskImagePath est trop long. Le chemin d’accès doit être inférieur à MAX_PATH (260) caractères.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) 0x80070020	Le disque dur virtuel référencé par cet objet est en cours d’utilisation ou le parent de ce disque dur virtuel est en cours d’utilisation.
HRESULT_FROM_WIN32(ERROR_DISK_FULL) 0x80070070	Le volume hôte ne dispose pas de suffisamment d’espace pour convertir ce disque dur virtuel.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) 0x800700b7	Le fichier référencé par le paramètre convertedDiskImagePath existe déjà.
VM_E_WRONG_HD_IMAGE_TYPE 0xA004067B	Le paramètre convertedDiskImagePath doit être vmDiskType_Dynamic ou vmDiskType_FixedSize.
VM_E_INVALID_HD_FILE 0xA0040682	L’image de disque dur virtuel référencée par cet objet IVMHardDisk ne semble pas être une image valide.
VM_E_PARENT_PATH_NOT_FOUND 0xA0040677	Le parent du disque dur virtuel référencé par cet objet n’existe pas.
VM_E_APP_SHUTTING_DOWN 0xA0040209	L’image de disque dur virtuel ne peut pas être convertie, car l’application s’arrête.
DISP_E_EXCEPTION 0x80020009	Une erreur inattendue s’est produite.

Notes

Le fichier source est laissé intact après le processus de conversion.

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_IVMHardDisk est défini comme ffa14ae6-48f5-42a4-8a22-186f2e5c7db0

Voir aussi

IVMHardDisk

Partager via