Compartilhar via


Método IVMVirtualPC::GetVirtualMachineFiles

[O Computador Virtual do Windows 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 uma matriz de arquivos de configuração de máquina virtual conhecidos.

Sintaxe

HRESULT GetVirtualMachineFiles(
  [in]          VARIANT      inAdditionalSearchPaths,
  [in]          VARIANT_BOOL inExcludedRegisteredVMs,
  [out, retval] VARIANT      *outVirtualMachineFileList
);

Parâmetros

inAdditionalSearchPaths [in]

Esses caminhos serão pesquisados junto com os caminhos definidos nas propriedades IVMVirtualPC::SearchPaths e IVMVirtualPC::D efaultVMConfigurationPath .

inExcludedRegisteredVMs [in]

TRUE se as máquinas virtuais registradas devem ser excluídas do retorno da matriz no parâmetro outVirtualMachineFileList e FALSE caso contrário.

outVirtualMachineFileList [out, retval]

Uma matriz de cadeias de caracteres de caminho para os arquivos de configuração de máquina virtual encontrados nos caminhos de pesquisa especificados.

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.
E_POINTER
0x80004003
O parâmetro outVirtualMachineFileList é NULL.
E_INVALIDARG
0x80000003
O parâmetro inAdditionalSearchPaths não é uma matriz de cadeias de caracteres.
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 caminhos de pesquisa usados para recuperar a matriz de arquivos de configuração incluirão aqueles definidos anteriormente por IVMVirtualPC::SearchPaths e IVMVirtualPC::D efaultVMConfigurationPath , além daqueles especificados pelo parâmetro inAdditionalSearchPaths .

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