Compartilhar via


Método IVMVirtualPC::FindVirtualNetwork

[Windows Computador Virtual não está mais disponível para uso a partir de Windows 8. Em vez disso, use o provedor WMI do Hyper-V (V2).]

Recupera um objeto de rede virtual que corresponde ao nome solicitado.

Sintaxe

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

Parâmetros

virtualNetworkName [in]

O nome da rede virtual a ser encontrada.

virtualNetwork [out, retval]

Um ponteiro para um novo objeto IVMVirtualNetwork que representa essa rede virtual.

Valor retornado

Esse método pode retornar um desses valores.

Retornar código/valor Descrição
S_OK
0
A operação foi bem-sucedida.
S_FALSE
1
Não foi possível encontrar a rede virtual especificada.
E_POINTER
0x80004003
O parâmetro virtualNetwork é NULL ou a rede virtual não pode ser encontrada.
E_INVALIDARG
0x80000003
O parâmetro virtualNetworkName não é válido ou é uma cadeia de caracteres vazia.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
Não foi possível encontrar o arquivo de rede virtual.
DISP_E_EXCEPTION
0x80020009
Ocorreu um erro inesperado.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
O processador não dá suporte a extensões HAV (Virtualização Acelerada por Hardware).

Comentários

Os nomes de rede virtual não diferenciam maiúsculas de minúsculas, por exemplo, "MyNetwork" e "mynetwork" referem-se à mesma rede virtual.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Nenhum compatível
Fim do suporte ao cliente
Windows 7
Produto
Windows Virtual PC
Cabeçalho
VPCCOMInterfaces.h
IID
IID_IVMVirtualPC é definido como 236ba0d9-a24a-4292-a132-27c1421dfd01

Confira também

IVMVirtualPC