Propriedade IVMVirtualMachine::Name
[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 |
|---|---|
|
A operação foi bem-sucedida. |
|
O parâmetro é NULL. |
|
O parâmetro não é válido ou é uma cadeia de caracteres vazia. |
|
A configuração é desconhecida. |
|
A máquina virtual está em execução ou salva. |
|
O parâmetro virtualMachineName está vazio. |
|
O parâmetro contém muitos caracteres. |
|
O parâmetro contém um dos seguintes caracteres inválidos "*?:<>/|\"". |
|
O nome especificado já existe como o nome de outra máquina virtual. |
|
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 |
|
| IID |
IID_IVMVirtualMachine é definido como f7092aa1-33ed-4f78-a59f-c00adfc2edd7 |