IVMVirtualPC::CreateDifferencingVirtualHardDisk, 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 différenciation.

Syntaxe

HRESULT CreateDifferencingVirtualHardDisk(
  [in]          BSTR    imagePath,
  [in]          BSTR    parentPath,
  [out, retval] IVMTask **diskTask
);

Paramètres

imagePath [in]: Chemin d’accès au nouveau fichier image disque. Le dossier contenant est créé s’il n’existe pas.
parentPath [in]: Chemin d’accès au fichier d’image de disque parent.
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.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	Le système ne peut pas trouver le chemin spécifié par le paramètre imagePath ou parentPath .
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 ou parentPath contient un caractère non valide (l’un des « *?:<>/\| »).
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Le paramètre imagePath et parentPath spécifient 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 les paramètres imagePath ou parentPath 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.

Notes

Bien que imagePath ou parentPath puisse être un chemin relatif, au moins l’un d’entre eux doit être un chemin absolu. Si un paramètre de chemin d’accès est un chemin relatif, il est supposé être relatif à l’autre paramètre de chemin d’accès.

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