IVMVirtualPC::CreateDynamicVirtualHardDisk, 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).]

Crée un disque dur virtuel de redimensionnement dynamique.

Syntaxe

HRESULT CreateDynamicVirtualHardDisk(
  [in]          BSTR    imagePath,
  [in]          long    size,
  [out, retval] IVMTask **diskTask
);

Paramètres

imagePath [in]: Chemin d’accès complet au nouveau fichier image disque. Le dossier contenant est créé s’il n’existe pas.
size [in]: Taille de l’image, en mégaoctets. Cette valeur peut être au maximum de 2 088 960 Mo (2 040 Go).
diskTask [out, retval]: Objet IVMTask utilisé pour suivre la création de l’image.

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	Un paramètre a la valeur NULL.
E_INVALIDARG 0x80000003	Le paramètre size est inférieur ou égal à 0.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	Le système ne peut pas trouver le chemin spécifié par le paramètre imagePath .
HRESULT_FROM_WIN32(ERROR_INVALID_DRIVE) 0x8007000f	Le fichier spécifié par le paramètre imagePath se trouve sur un CD-ROM ou un DVD-ROM.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Le paramètre imagePath contient un caractère non valide (l’un des « *?:<>/\| » »).
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Le paramètre imagePath spécifie un chemin d’accès vide ou relatif. Au moins l’un des paramètres doit être un chemin absolu.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Le chemin spécifié par le paramètre imagePath est trop long. La longueur du chemin d’accès doit être inférieure à 260 caractères.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) 0x800700b7	Le fichier référencé par le paramètre imagePath existe déjà.
HRESULT_FROM_WIN32(ERROR_DISK_FULL) 0x80070070	L’image de disque dur virtuel à expansion dynamique a besoin d’au moins 8 Mo libres sur le volume hôte.
VM_E_IMAGE_SIZE_TOO_LARGE 0xA0040683	La taille du paramètre doit être inférieure à 2 088 960 Mo. Si le format est FAT16, la taille doit être inférieure à 2 000 Mo.
VM_E_IMAGE_SIZE_TOO_SMALL 0xA0040684	Les images de disque dur virtuel au format FAT16 et non mises en forme doivent avoir au moins 3 Mo. Les images de disque dur virtuel au format FAT32 doivent avoir au moins 514 Mo.
VM_E_FILE_TOO_LARGE_FOR_VOLUME 0xA0040679	Le volume hôte ne peut pas prendre en charge un fichier de cette taille si l’image de disque dur virtuel à expansion dynamique atteint sa limite totale. La taille de fichier maximale d’un volume FAT32 est de 4 Go. La taille de fichier maximale d’un volume FAT16 est de 2 Go.
VM_E_APP_SHUTTING_DOWN 0xA0040209	Impossible de créer le disque dur virtuel une fois que l’application a commencé à s’arrêter.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED 0xA0040951	Le processeur ne prend pas en charge les extensions HAV (Hardware Accelerated Virtualization).
DISP_E_EXCEPTION 0x80020009	Une erreur inattendue s’est produite.

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_IVMVirtualPC est défini comme 236ba0d9-a24a-4292-a132-27c1421dfd01

Voir aussi

IVMVirtualPC

Partager via