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
S _ OK
0
L'opération a réussi.
E _ POINTEUR
0x80004003
Le paramètre hardDiskConnection a la valeur null.
E _ INVALIDARG
0x80000003
Un paramètre hardDiskPath a la valeur null ou le paramètre busNumber ou deviceNumber n’est pas valide.
Valeur
HRESULT _ FROM _ Win32 ( _ fichier d' _ erreur _ introuvable)
0x80070002
Le système ne peut pas trouver le fichier spécifié par le paramètre hardDiskPath .
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 hardDiskPath .
Valeur
HRESULT _ À partir de _ Win32 (erreur _ _ nom non valide)
0x8007007b
Le paramètre hardDiskPath contient un caractère non valide (l’un des caractères * suivants : «  ? <>/ | » :»).
Valeur
HRESULT _ FROM _ Win32 (erreur _ de _ nom de chemin incorrect)
0x800700a1
Le paramètre hardDiskPath 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 hardDiskPath est trop long. Le chemin d’accès doit être inférieur à 260 caractères.
Ordinateur virtuel _ _Machine virtuelle _
0xA0040207
inconnue
La configuration est inconnue.
Ordinateur virtuel _ _Machine virtuelle _ en cours d’exécution _ ou _
0xA004020B
L’ordinateur virtuel est dans un État en cours d’exécution ou enregistré.
Ordinateur virtuel _ 0xA00400503 _ _ de bus _ de lecteur E _ en cours d' _ utilisation
L’emplacement de bus spécifié est en cours d’utilisation.
Ordinateur virtuel _ E _ _ _ fichier HD 0xA0040682 non valide
Le disque dur virtuel est supérieur à 127 Go et ne peut pas être connecté au bus IDE.
Ordinateur virtuel _ E _ _ _ _ type de disque HD non pris en charge
0xA00400686
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.
Valeur
HRESULT _ À partir de _ Win32 _ ( _ violation de partage d’erreur)
0x80070020
Le disque dur virtuel spécifié est déjà connecté à un autre emplacement de bus pour cette machine virtuelle.
DISP _ E _ exception
0x80020009
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
VPCCOMInterfaces. h
IID
IID _ IVMVirtualMachine est défini en tant que f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Voir aussi

IVMVirtualMachine