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 |
|---|---|
|
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 d’accès 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 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. |
|
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. |
|
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. |
|
Le fichier référencé par le paramètre newDiskImagePath existe déjà. |
|
Le volume hôte ne dispose pas de suffisamment d’espace pour fusionner ce disque dur virtuel. |
|
Le parent du disque dur virtuel référencé par cet objet n’existe pas. |
|
Impossible de fusionner l’image de disque dur virtuel, car l’application est en cours d’arrêt. |
|
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 |
|
| IID |
IID _ IVMHardDisk est défini en tant que ffa14ae6-48f5-42A4-8a22-186f2e5c7db0 |