IVMVirtualPC::CreateDifferencingVirtualHardDisk, méthode

  • Article

[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