IVMHardDisk::Convert, méthode

  • Article

[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