IVMHardDisk::MergeTo, méthode
[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.
HRESULT MergeTo(
[in] BSTR newDiskImagePath,
[in] VMHardDiskType newDiskImageType,
[out, retval] IVMTask **mergeTask
);
-
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.
Cette méthode peut retourner l’une de ces valeurs.
Code/valeur de retour | Description |
---|---|
|
L'opération a réussi. |
|
Un paramètre a la valeur NULL. |
|
Le paramètre newDiskImagePath est vide. |
|
Le système ne peut pas trouver le fichier spécifié par le paramètre newDiskImagePath . |
|
Le système ne trouve pas le chemin spécifié par le paramètre newDiskImagePath . |
|
Le paramètre newDiskImagePath contient un caractère non valide (l’un des éléments suivants : « *?<> /|":"). |
|
Le paramètre newDiskImagePath spécifie un chemin d’accès vide ou relatif. Un chemin d’accès absolu est requis. |
|
Le chemin spécifié par le paramètre newDiskImagePath est trop long. Le chemin d’accès doit être inférieur à 260 caractères. |
|
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. |
|
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. |
|
Le fichier référencé par le paramètre newDiskImagePath existe déjà. |
|
Le volume hôte n’a pas assez d’espace pour fusionner ce disque dur virtuel. |
|
Le parent du disque dur virtuel référencé par cet objet n’existe pas. |
|
L’image de disque dur virtuel ne peut pas être fusionnée, car l’application s’arrête. |
|
Une erreur inattendue s’est produite. |
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 |
|
IID |
IID_IVMHardDisk est défini comme ffa14ae6-48f5-42a4-8a22-186f2e5c7db0 |