Compartilhar via


Método IVMVirtualPC::CreateVirtualMachine

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

Cria uma nova configuração de máquina virtual e recupera o objeto de máquina virtual.

Sintaxe

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

Parâmetros

configurationName [in]

O nome da máquina virtual a ser criada. O comprimento do nome não pode exceder 80 caracteres e o comprimento combinado do nome e do caminho para arquivos VMC e VMCX não pode exceder MAX_PATH (260) caracteres. As extensões de nome de arquivo .vmc e .vmcx serão acrescentadas ao final do nome da máquina virtual quando os arquivos de configuração forem criados. Se esse parâmetro for NULL ou uma cadeia de caracteres vazia, o parâmetro configurationPath deverá especificar o caminho completo para o arquivo VMC.

configurationPath [in]

O caminho para a pasta que conterá o arquivo VMC. Essa pasta será criada se ela não existir. Se configurationName for NULL ou uma cadeia de caracteres vazia, isso deverá especificar o caminho completo do novo arquivo de configuração.

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.

Código/valor de retorno Descrição
S_OK
0
A operação foi bem-sucedida.
E_POINTER
0x80004003
O parâmetro configurationName ou configurationPath não é válido ou o parâmetro virtualMachine é NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
O sistema não pode localizar o caminho especificado pelo parâmetro 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 total 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_NO_NAME
0xA0040400
O parâmetro configurationName está vazio.
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