Método IVMVirtualPC::FindVirtualMachine

  • 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 máquina virtual que corresponde à configuração solicitada.

Sintaxe

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

Parâmetros

configurationName [in]

O nome da máquina virtual a ser encontrada.

virtualMachine [out, retval]

Um ponteiro para um novo objeto IVMVirtualMachine que representa essa máquina 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 configuração especificada.
E_POINTER
0x80004003
 O parâmetro configurationName é inválido ou virtualMachine é NULL.
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

Nomes de máquinas virtuais não diferenciam maiúsculas de minúsculas, por exemplo, "MyVM" e "myvm" referem-se à mesma máquina 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