IVMVirtualMachine :: AddHardDiskConnection, 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).]
Ajoute une nouvelle connexion de disque dur à la machine virtuelle.
Syntaxe
HRESULT AddHardDiskConnection(
[in] BSTR hardDiskPath,
[in] long busNumber,
[in] long deviceNumber,
[out, retval] IVMHardDiskConnection **hardDiskConnection
);
Paramètres
-
hardDiskPath [ dans]
-
Le chemin d’accès complet du fichier de disque dur virtuel (VHD) pour se connecter.
-
busNumber [ dans]
-
Bus auquel le lecteur sera attaché.
Valeur Signification - 0
Le lecteur sera attaché au premier bus. - 1
Le lecteur sera attaché au second bus. -
deviceNumber [ dans]
-
Appareil auquel le lecteur sera attaché.
Valeur Signification - 0
Le lecteur sera attaché au premier périphérique sur le bus. - 1
Le lecteur sera attaché au deuxième périphérique sur le bus. -
hardDiskConnection [ out, retval]
-
Objet IVMHardDiskConnection .
Valeur renvoyé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 hardDiskConnection a la valeur null. |
|
Un paramètre hardDiskPath a la valeur null ou le paramètre busNumber ou deviceNumber n’est pas valide. |
|
Le système ne peut pas trouver le fichier spécifié par le paramètre hardDiskPath . |
|
Le système ne trouve pas le chemin d’accès spécifié par le paramètre hardDiskPath . |
|
Le paramètre hardDiskPath contient un caractère non valide (l’un des caractères * suivants : « ? <>/ | » :»). |
|
Le paramètre hardDiskPath 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 hardDiskPath est trop long. Le chemin d’accès doit être inférieur à 260 caractères. |
|
La configuration est inconnue. |
|
L’ordinateur virtuel est dans un État en cours d’exécution ou enregistré. |
|
L’emplacement de bus spécifié est en cours d’utilisation. |
|
Le disque dur virtuel est supérieur à 127 Go et ne peut pas être connecté au bus IDE. |
|
Le paramètre hardDiskPath fait référence à un disque dur virtuel lié ou à un disque dur virtuel de différenciation sur un disque dur virtuel lié. Les disques durs virtuels liés ne peuvent pas être attachés aux machines virtuelles. |
|
Le disque dur virtuel spécifié est déjà connecté à un autre emplacement de bus pour cette machine virtuelle. |
|
Une erreur inattendue s’est produite. |
Notes
Vous pouvez uniquement ajouter une nouvelle connexion de disque dur à une machine virtuelle arrêtée.
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 _ IVMVirtualMachine est défini en tant que f7092aa1-33ed-4f78-a59f-c00adfc2edd7 |