IVMHardDisk::MergeTo, méthode

  • Article

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

Fusionne un disque dur virtuel différentiant avec tous ses parents (jusqu’au disque dur virtuel parent racine inclus) à un nouveau fichier de disque dur.

Syntaxe

HRESULT MergeTo(
  [in]          BSTR           newDiskImagePath,
  [in]          VMHardDiskType newDiskImageType,
  [out, retval] IVMTask        **mergeTask
);

Paramètres

newDiskImagePath [in]

Chemin d’accès à la nouvelle image de disque cible dans laquelle les images de disque sélectionnées seront fusionnées.

newDiskImageType [in]

Type de nouvelle image de disque cible. Les types d’images autorisés pour la nouvelle image disque cible sont vmDiskType_Dynamic et vmDiskType_FixedSize. Pour plus d’informations, consultez VMHardDiskType.

mergeTask [out, retval]

Objet IVMTask utilisé pour suivre l’achèvement du processus de fusion.

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 newDiskImagePath est vide.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 Le système ne peut pas trouver le fichier spécifié par le paramètre newDiskImagePath .
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 Le système ne trouve pas le chemin spécifié par le paramètre newDiskImagePath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 Le paramètre newDiskImagePath contient un caractère non valide (l’un des éléments suivants : « *?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 Le paramètre newDiskImagePath 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 spécifié par le paramètre newDiskImagePath est trop long. Le chemin d’accès doit être inférieur à 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.
VM_E_WRONG_HD_IMAGE_TYPE
0xA004067B
 Cette erreur est due au fait que l’image de disque dur virtuel référencée par cet objet IVMHardDisk n’est pas une image de disque de différenciation ou parce que le paramètre newDiskImageType n’est pas l’une des valeurs acceptées, vmDiskType_Dynamic ou vmDiskType_FixedSize.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 Le fichier référencé par le paramètre newDiskImagePath existe déjà.
HRESULT_FROM_WIN32(ERROR_DISK_FULL)
0x80070070
 Le volume hôte n’a pas assez d’espace pour fusionner ce disque dur virtuel.
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 fusionnée, car l’application s’arrête.
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_IVMHardDisk est défini comme ffa14ae6-48f5-42a4-8a22-186f2e5c7db0

Voir aussi

IVMHardDisk