IVMHardDisk :: MergeTo, méthode

[Windows Virtual PC ne peut plus être utilisé à partir de Windows 8. Au lieu de cela, utilisez le fournisseur WMI Hyper-V (v2).]

Fusionne un disque dur virtuel de différenciation avec tous ses parents (jusqu’à et y compris le disque dur virtuel parent racine) vers un nouveau fichier de disque dur.

Syntaxe

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

Paramètres

newDiskImagePath [ dans]

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

newDiskImageType [ dans]

Type de nouvelle image de disque cible. Les types d’images autorisés pour la nouvelle image de 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 _ POINTEUR
0x80004003
Un paramètre a la valeur null.
E _ INVALIDARG
0x80000003
Le paramètre newDiskImagePath est vide.
Valeur
HRESULT _ FROM _ Win32 ( _ fichier d' _ erreur _ introuvable)
0x80070002
Le système ne peut pas trouver le fichier spécifié par le paramètre newDiskImagePath .
Valeur
HRESULT _ À partir de _ Win32 ( _ chemin d’erreur _ _ introuvable)
0x80070003
Le système ne trouve pas le chemin d’accès spécifié par le paramètre newDiskImagePath .
Valeur
HRESULT _ À partir de _ Win32 (erreur _ _ nom non valide)
0x8007007b
Le paramètre newDiskImagePath contient un caractère non valide (l’un des éléments suivants : " * ? <>/ | " : ").
Valeur
HRESULT _ FROM _ Win32 (erreur _ de _ nom de chemin incorrect)
0x800700a1
Le paramètre newDiskImagePath spécifie un chemin d’accès vide ou relatif. Un chemin d’accès absolu est requis.
Valeur
HRESULT _ À partir de _ Win32 _ ( _ dépassement de mémoire tampon d’erreur)
0x8007006f
Le chemin d’accès spécifié par le paramètre newDiskImagePath est trop long. Le chemin d’accès doit être inférieur à 260 caractères.
Valeur
HRESULT _ À partir de _ Win32 _ ( _ violation de partage d’erreur)
0x80070020
Soit le disque dur virtuel référencé par cet objet est en cours d’utilisation, soit le parent de ce disque dur virtuel est en cours d’utilisation.
Ordinateur virtuel _ E _ mauvais _ _ _ type d’image HD
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 que le paramètre newDiskImageType n’est pas l’une des valeurs acceptées, vmDiskType _ Dynamic ou vmDiskType _ FixedSize.
Valeur
HRESULT _ À partir de _ Win32 (l’erreur _ _ existe déjà)
0x800700b7
Le fichier référencé par le paramètre newDiskImagePath existe déjà.
Valeur
HRESULT _ À partir de _ Win32 (disque d’erreur _ _ saturé)
0x80070070
Le volume hôte ne dispose pas de suffisamment d’espace pour fusionner ce disque dur virtuel.
Ordinateur virtuel _ _Chemin parent _ E _ _ introuvable
0xA0040677
Le parent du disque dur virtuel référencé par cet objet n’existe pas.
Ordinateur virtuel _ _ _ Arrêt _
de l’application
0xA0040209
Impossible de fusionner l’image de disque dur virtuel, car l’application est en cours d’arrêt.
DISP _ E _ exception
0x80020009
Une erreur inattendue s’est produite.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
applications de [ bureau Windows 7 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 en tant que ffa14ae6-48f5-42A4-8a22-186f2e5c7db0

Voir aussi

IVMHardDisk