IVMVirtualMachine::AddHardDiskConnection, méthode

Article
06/13/2023

[Windows Virtual PC n’est plus disponible depuis Windows 8. Utilisez plutôt 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 [in]

Chemin d’accès complet du fichier de disque dur virtuel (VHD) à connecter.

busNumber [in]

Bus auquel le lecteur sera attaché.

Valeur	Signification
0	Le lecteur sera attaché au premier bus.
1	Le lecteur sera attaché au deuxième bus.

deviceNumber [in]

Appareil auquel le lecteur sera attaché.

Valeur	Signification
0	Le lecteur sera attaché au premier appareil du bus.
1	Le lecteur sera attaché au deuxième appareil sur le bus.

hardDiskConnection [out, retval]

Objet IVMHardDiskConnection .

Valeur retourné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_POINTER 0x80004003	Le paramètre hardDiskConnection est NULL.
E_INVALIDARG 0x80000003	Un paramètre hardDiskPath est NULL ou le paramètre busNumber ou deviceNumber n’est pas valide.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	Le système ne peut pas trouver le fichier spécifié par le paramètre hardDiskPath .
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	Le système ne trouve pas le chemin spécifié par le paramètre hardDiskPath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Le paramètre hardDiskPath contient un caractère non valide (l’un des « * ? »<> /\|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Le paramètre hardDiskPath spécifie un chemin d’accès vide ou relatif. Un chemin d’accès absolu est requis.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Le chemin spécifié par le paramètre hardDiskPath est trop long. Le chemin doit comporter moins de 260 caractères.
VM_E_VM_UNKNOWN 0xA0040207	La configuration est inconnue.
VM_E_VM_RUNNING_OR_SAVED 0xA004020B	La machine virtuelle est en cours d’exécution ou enregistrée.
VM_E_DRIVE_BUS_LOC_IN_USE 0xA00400503	L’emplacement de bus spécifié est en cours d’utilisation.
VM_E_INVALID_HD_FILE 0xA0040682	Le disque dur virtuel est supérieur à 127 Go et ne peut pas être connecté au bus IDE.
VM_E_UNSUPPORTED_HD_DISK_TYPE 0xA00400686	Le paramètre hardDiskPath fait référence à un disque dur virtuel lié ou à un disque dur virtuel de différenciation à un disque dur virtuel lié. Les disques durs virtuels liés ne peuvent pas être attachés à des machines virtuelles.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) 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.

Spécifications

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	VPCCOMInterfaces.h
IID	IID_IVMVirtualMachine est défini comme f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Voir aussi

IVMVirtualMachine

Share via