Share via

Propriedade IVMVirtualMachine::Name

  • Artigo

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

Recupera e define o nome da configuração da máquina virtual.

Essa propriedade é leitura/gravação.

Syntax

HRESULT put_Name(
  [in]          BSTR virtualMachineName
);

HRESULT get_Name(
  [out, retval] BSTR *virtualMachineName
);

Valor da propriedade

Especifica o nome da configuração da máquina virtual. O comprimento do nome não pode ter mais de 80 caracteres e o comprimento total do caminho totalmente qualificado que inclui o arquivo de configuração de nome da máquina virtual não pode ter mais de MAX_PATH (260) caracteres.

Códigos de erro

Nome/valor Significado
S_OK
0
 A operação foi bem-sucedida.
E_POINTER
0x80004003
 O parâmetro é NULL.
E_INVALIDARG
0x80000003
 O parâmetro não é válido ou é uma cadeia de caracteres vazia.
VM_E_VM_UNKNOWN
0xA0040207
 A configuração é desconhecida.
VM_E_PREF_VM_ACTIVE
0xA0040302
 A máquina virtual está em execução ou salva.
VM_E_CONFIG_NO_NAME
0xA0040400
 O parâmetro virtualMachineName está vazio.
VM_E_CONFIG_NAME_TOO_LONG
0xA00400401
 O parâmetro contém muitos caracteres.
VM_E_CONFIG_NAME_INVALID_CHAR
0xA0040402
 O parâmetro contém um dos seguintes caracteres inválidos "*?:<>/|\"".
VM_E_CONFIG_DUPLICATE_NAME
0xA0040403
 O nome especificado já existe como o nome de outra máquina virtual.
DISP_E_EXCEPTION
0x80020009
 Ocorreu um erro inesperado.

Comentários

Os nomes de máquina virtual não diferenciam maiúsculas de minúsculas, por exemplo, "MyVM" e "myvm" referem-se à mesma máquina virtual. Essa é a propriedade padrão para IVMVirtualMachine.

Se VPC.exe estiver em execução e a VM for salva, a definição da propriedade Name não terá êxito. Se VPC.exe não estiver em execução e a VM for salva, a definição da propriedade Name terá êxito quando VPC.exe for iniciado.

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_IVMVirtualMachine é definido como f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Confira também

IVMVirtualMachine