Metodo IVMVirtualPC::FindVirtualNetwork

  • Articolo
  • 2 minuti per la lettura

[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 di rete virtuale corrispondente al nome richiesto.

Sintassi

HRESULT FindVirtualNetwork(
  [in]          BSTR              virtualNetworkName,
  [out, retval] IVMVirtualNetwork **virtualNetwork
);

Parametri

virtualNetworkName [in]

Nome della rete virtuale da trovare.

virtualNetwork [out, retval]

Puntatore a un nuovo oggetto IVMVirtualNetwork che rappresenta questa rete 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 rete virtuale specificata.
E_POINTER
0x80004003
 Il parametro virtualNetwork è NULL o non è possibile trovare la rete virtuale.
E_INVALIDARG
0x80000003
 Il parametro virtualNetworkName non è valido o è una stringa vuota.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 Impossibile trovare il file di rete virtuale.
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 di rete virtuale non fanno distinzione tra maiuscole e minuscole, ad esempio "MyNetwork" e "mynetwork" fanno riferimento alla stessa rete 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