Método IVMVirtualPC::RegisterVirtualMachine

  • Artigo

[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).]

Registra uma configuração de máquina virtual existente e recupera o objeto de máquina virtual.

Sintaxe

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

Parâmetros

configurationName [in]

O nome da máquina virtual a ser registrada. O comprimento do nome não pode exceder 80 caracteres e o comprimento combinado do nome e do caminho não pode exceder MAX_PATH (260) caracteres. O nome especificado pode conter a extensão .vmc. Se esse parâmetro for NULL ou uma cadeia de caracteres vazia, o parâmetro configurationPath deverá especificar o caminho completo para o arquivo de configuração.

configurationPath [in]

O caminho para a pasta que contém o arquivo de configuração existente. Se o parâmetro configurationName for NULL ou uma cadeia de caracteres vazia, isso deverá especificar o caminho completo para o arquivo de configuração existente.

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.
E_POINTER
0x80004003
 O parâmetro configurationName ou configurationPath é inválido ou virtualMachine é NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 O sistema não pode encontrar o caminho especificado pelos parâmetros configurationName e configurationPath .
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 O sistema não pode encontrar o arquivo especificado pelos parâmetros configurationName e configurationPath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 O parâmetro configurationPath contém um caractere inválido (um de "*?:<>/|"").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 O parâmetro configurationPath especifica um caminho vazio ou relativo. Um caminho absoluto é necessário.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 O caminho especificado pelos parâmetros configurationName e configurationPath resulta em um caminho muito longo. O comprimento combinado do caminho deve ser menor que MAX_PATH (260) caracteres.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 Um arquivo de configuração com esse nome já existe neste local.
VM_E_CONFIG_NAME_TOO_LONG
0xA0040401
 O parâmetro configurationName excede 80 caracteres de comprimento.
VM_E_CONFIG_NAME_INVALID_CHAR
0xA0040402
 O parâmetro configurationName contém um caractere inválido (um de "*?:<>/|\"").
VM_E_CONFIG_DUPLICATE_NAME
0xA0040403
 Já existe uma máquina virtual com esse nome.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 O processador não dá suporte a extensões HAV (Virtualização Acelerada por Hardware).
DISP_E_EXCEPTION
0x80020009
 Ocorreu um erro inesperado.

Comentários

Os nomes das 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