Metodo IVMVirtualPC::RegisterVirtualMachine

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).]

Registra una configurazione di macchina virtuale esistente e recupera l'oggetto macchina virtuale.

Sintassi

HRESULT RegisterVirtualMachine(
  [in]          BSTR              configurationName,
  [in]          BSTR              configurationPath,
  [out, retval] IVMVirtualMachine **virtualMachine
);

Parametri

configurationName [in]: Nome della macchina virtuale da registrare. La lunghezza del nome non può superare 80 caratteri e la lunghezza combinata del nome e del percorso non può superare MAX_PATH (260). Il nome specificato può contenere l'estensione vmc. Se questo parametro è NULL o una stringa vuota, il parametro configurationPath deve specificare il percorso completo del file di configurazione.
configurationPath [in]: Percorso della cartella contenente il file di configurazione esistente. Se il parametro configurationName è NULL o una stringa vuota, è necessario specificare il percorso completo del file di configurazione esistente.
virtualMachine [out, retval]: Puntatore a un nuovo oggetto IVMVirtualMachine che rappresenta questa macchina virtuale.

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 configurationName o configurationPath non è valido oppure virtualMachine è NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	Il sistema non riesce a trovare il percorso specificato dai parametri configurationName e configurationPath .
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	Il sistema non riesce a trovare il file specificato dai parametri configurationName e configurationPath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Il parametro configurationPath contiene un carattere non valido (uno di "*?:<>/\|"").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Il parametro configurationPath del parametro specifica un percorso vuoto o relativo. È necessario un percorso assoluto.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Il percorso specificato dai parametri configurationName e configurationPath restituisce un percorso troppo lungo. La lunghezza combinata del percorso deve essere minore di MAX_PATH (260).
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) 0x800700b7	Esiste già un file di configurazione con questo nome in questo percorso.
VM_E_CONFIG_NAME_TOO_LONG 0xA0040401	Il parametro configurationName supera 80 caratteri di lunghezza.
VM_E_CONFIG_NAME_INVALID_CHAR 0xA0040402	Il parametro configurationName contiene un carattere non valido (uno di "*?:<>/\|\"").
VM_E_CONFIG_DUPLICATE_NAME 0xA0040403	Esiste già una macchina virtuale con questo nome.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED 0xA0040951	Il processore non supporta le estensioni HAV (Hardware Accelerated Virtualization).
DISP_E_EXCEPTION 0x80020009	Si è verificato un errore imprevisto.

Commenti

I nomi delle macchine virtuali non fanno distinzione tra maiuscole e minuscole, ad esempio "MyVM" e "myvm" fanno riferimento alla stessa macchina virtuale.

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_IVMVirtualPC è definito come 236ba0d9-a24a-4292-a132-27c1421dfd01

Vedi anche

IVMVirtualPC

Condividi tramite