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 |
---|---|
|
A operação foi bem-sucedida. |
|
O parâmetro configurationName ou configurationPath não é válido ou o parâmetro virtualMachine é NULL. |
|
O sistema não pode localizar o caminho especificado pelo parâmetro configurationPath . |
|
O parâmetro configurationPath contém um caractere inválido (um de "*?:<>/|""). |
|
O parâmetro configurationPath especifica um caminho vazio ou relativo. Um caminho absoluto é necessário. |
|
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. |
|
Um arquivo de configuração com esse nome já existe neste local. |
|
O parâmetro configurationName está vazio. |
|
O parâmetro configurationName excede 80 caracteres de comprimento. |
|
O parâmetro configurationName contém um caractere inválido (um de "*?:<>/|\""). |
|
Já existe uma máquina virtual com esse nome. |
|
O processador não dá suporte a extensões HAV (Virtualização Acelerada por Hardware). |
|
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 |
|
IID |
IID_IVMVirtualPC é definido como 236ba0d9-a24a-4292-a132-27c1421dfd01 |