Metodo IVMVirtualPC::FindVirtualMachine

  • Articolo

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

Recupera un oggetto macchina virtuale che corrisponde alla configurazione richiesta.

Sintassi

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

Parametri

configurationName [in]

Nome della macchina virtuale da trovare.

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.
S_FALSE
1
 Impossibile trovare la configurazione specificata.
E_POINTER
0x80004003
 Il parametro configurationName non è valido o virtualMachine è NULL.
DISP_E_EXCEPTION
0x80020009
 Si è verificato un errore imprevisto.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 Il processore non supporta le estensioni haV (Hardware Accelerated Virtualization).

Commenti

I nomi delle macchine virtuali sono senza 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