IVMHardDisk :: Convert, 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).]
Convertit un disque dur virtuel de taille fixe en disque dur virtuel de taille dynamique ou convertit un disque dur virtuel de taille dynamique en disque dur virtuel de taille fixe.
Syntaxe
HRESULT Convert(
[in] BSTR convertedDiskImagePath,
[in] VMHardDiskType convertedDiskImageType,
[out, retval] IVMTask **convertTask
);
Paramètres
-
convertedDiskImagePath [ dans]
-
Chemin d’accès au fichier image de disque cible.
-
convertedDiskImageType [ dans]
-
Type de l’image de disque cible. Pour obtenir la liste des valeurs, consultez VMHardDiskType.
-
convertTask [ out, retval]
-
Objet IVMTask utilisé pour suivre l’achèvement du processus de conversion.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code/valeur de retour | Description |
|---|---|
|
L'opération a réussi. |
|
Le paramètre convertedDiskImagePath est vide ou n’a pas d’extension. vhd sur le nom de fichier. |
|
Un paramètre a la valeur null. |
|
Le système ne trouve pas le chemin d’accès spécifié par le paramètre convertedDiskImagePath . |
|
Le paramètre convertedDiskImagePath contient un caractère non valide (l’un des caractères * suivants : « ? <>/ | » :»). |
|
Le paramètre convertedDiskImagePath 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 convertedDiskImagePath est trop long. Le chemin d’accès doit être inférieur à la longueur maximale _ (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. |
|
Le volume hôte ne dispose pas de suffisamment d’espace pour convertir ce disque dur virtuel. |
|
Le fichier référencé par le paramètre convertedDiskImagePath existe déjà. |
|
Le paramètre convertedDiskImagePath doit être VmDiskType _ dynamique ou vmDiskType _ FixedSize. |
|
L’image de disque dur virtuel référencée par cet objet IVMHardDisk ne semble pas être une image valide. |
|
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 convertie parce que l’application est en cours d’arrêt. |
|
Une erreur inattendue s’est produite. |
Remarques
Le fichier source reste intact après le processus de conversion.
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 |