Método IVMVirtualPC::FindVirtualNetwork

  • Artigo

[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