Metodo IVMVirtualMachine::AddHardDiskConnection

Articolo
06/13/2023

[PC virtuale Windows non è più disponibile per l'uso a partire da Windows 8. Usare invece il provider WMI Hyper-V (V2).]

Aggiunge una nuova connessione disco rigido alla macchina virtuale.

Sintassi

HRESULT AddHardDiskConnection(
  [in]          BSTR                  hardDiskPath,
  [in]          long                  busNumber,
  [in]          long                  deviceNumber,
  [out, retval] IVMHardDiskConnection **hardDiskConnection
);

Parametri

hardDiskPath [in]

Percorso completo del file del disco rigido virtuale (VHD) da connettere.

busNumber [in]

L'autobus a cui verrà collegata l'unità.

Valore	Significato
0	L'unità verrà collegata al primo autobus.
1	L'unità verrà collegata al secondo autobus.

deviceNumber [in]

Dispositivo a cui verrà collegata l'unità.

Valore	Significato
0	L'unità verrà collegata al primo dispositivo sul bus.
1	L'unità verrà collegata al secondo dispositivo sul bus.

hardDiskConnection [out, retval]

Oggetto IVMHardDiskConnection .

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice/valore restituito	Descrizione
S_OK 0	L'operazione è stata completata.
E_POINTER 0x80004003	Il parametro hardDiskConnection è NULL.
E_INVALIDARG 0x80000003	Un parametro hardDiskPath è NULL o il parametro busNumber o deviceNumber non è valido.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	Il sistema non riesce a trovare il file specificato dal parametro hardDiskPath .
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	Il sistema non riesce a trovare il percorso specificato dal parametro hardDiskPath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Il parametro hardDiskPath contiene un carattere non valido (uno di "*?<> /\|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Il parametro hardDiskPath specifica un percorso vuoto o relativo. È necessario un percorso assoluto.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Il percorso specificato dal parametro hardDiskPath è troppo lungo. Il percorso deve essere inferiore a 260 caratteri.
VM_E_VM_UNKNOWN 0xA0040207	La configurazione è sconosciuta.
VM_E_VM_RUNNING_OR_SAVED 0xA004020B	La macchina virtuale si trova in uno stato in esecuzione o salvato.
VM_E_DRIVE_BUS_LOC_IN_USE 0xA00400503	La posizione del bus specificata è in uso.
VM_E_INVALID_HD_FILE 0xA0040682	Il disco rigido virtuale è maggiore di 127 GB e non può essere connesso al bus IDE.
VM_E_UNSUPPORTED_HD_DISK_TYPE 0xA00400686	Il parametro hardDiskPath fa riferimento a un disco rigido virtuale collegato o a un disco rigido virtuale diverso da un disco rigido virtuale collegato. I dischi rigidi virtuali collegati non possono essere collegati alle macchine virtuali.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) 0x80070020	Il disco rigido virtuale specificato è già connesso a un'altra posizione del bus per questa macchina virtuale.
DISP_E_EXCEPTION 0x80020009	Si è verificato un errore imprevisto.

Commenti

È possibile aggiungere una nuova connessione disco rigido a una macchina virtuale arrestata.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Nessuno supportato
Fine del supporto client	Windows 7
Prodotto	Windows Virtual PC
Intestazione	VPCCOMInterfaces.h
IID	IID_IVMVirtualMachine è definito come f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Vedi anche

IVMVirtualMachine

Share via