Metodo IVMVirtualPC::RegisterVirtualMachine

  • Articolo

[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