IVMVirtualPC::CreateFixedVirtualHardDisk, méthode

  • Article

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

Crée un disque dur virtuel de taille fixe.

Syntaxe

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

Paramètres

imagePath [in]

Chemin d’accès complet au nouveau fichier image de disque. Le dossier contenant est créé s’il n’existe pas.

size [in]

Taille, en mégaoctets, de l’image. La taille maximale est 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 est 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 un des paramètres doit être un chemin absolu.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 Le chemin d’accès spécifié par le paramètre imagePath est trop long. La longueur du chemin doit être inférieure à MAX_PATH (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 nécessite au moins 8 Mo de libre sur le volume hôte.
VM_E_IMAGE_SIZE_TOO_LARGE
0xA0040683
 Le paramètre size doit être inférieur à 2 088 960 Mo. Si le format est FAT16, le paramètre size doit être inférieur à 2 000 Mo.
VM_E_IMAGE_SIZE_TOO_SMALL
0xA0040684
 Les images de disque dur virtuel au format NON mis en forme et FAT16 doivent être d’au moins 3 Mo. Les images de disque dur virtuel au format FAT32 doivent être d’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. La taille de fichier maximale pour un volume FAT32 est de 4 Go. La taille de fichier maximale pour 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