Método IVMVirtualMachine::RemoveConfigurationValue
[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).]
Remove o valor da configuração especificada para esta máquina virtual.
Sintaxe
HRESULT RemoveConfigurationValue(
[in] BSTR configurationKey
);
Parâmetros
-
configurationKey [in]
-
A chave usada para identificar o valor de configuração como armazenado no arquivo "*.vmc".
Valor retornado
Esse método pode retornar um desses valores.
| Retornar código/valor | Descrição |
|---|---|
|
A operação foi bem-sucedida. |
|
O parâmetro é NULL ou vazio. |
|
A configuração é desconhecida. |
|
A preferência não foi encontrada. |
|
Ocorreu um erro inesperado. |
Comentários
Esse método fornece acesso de baixo nível a qualquer valor de configuração. Ele pode ser usado para remover valores de configuração para chaves definidas pelo cliente. Tenha cuidado se você usar esse método para remover valores de configuração do sistema, pois alguns valores não podem ser alterados enquanto a máquina virtual está em execução.
As chaves de configuração estão localizadas no arquivo "*.vmc" da máquina virtual no formato XML. As chaves são armazenadas de maneira hierárquica semelhante às chaves do Registro no Windows. Para especificar uma subchave específica, é construído um "caminho de chave" que especifica as várias chaves em um formato delimitado por marca de barra.
Por exemplo, para remover o valor da chave "ram_size" localizada na seguinte árvore de chaves:
<hardware>
<memory>
<ram_size type="integer">128</ram_size>
A cadeia de caracteres de caminho configurationKey seria especificada da seguinte maneira:
"hardware/memory/ram_size"
Se qualquer uma das chaves na árvore desejada tiver um valor de atributo "id", o atributo e seu valor serão inseridos na cadeia de caracteres de caminho configurationKey imediatamente após sua chave de configuração associada usando o seguinte formato entre colchetes: "[@id="id_value"]".
Por exemplo, para remover o valor da chave "absoluta" localizada na seguinte árvore de chaves:
<hardware>
<pci_bus>
<ide_adapter>
<ide_controller id="1">
<location id="0">
<pathname>
<absolute type="string">D</absolute>
A cadeia de caracteres de caminho configurationKey seria especificada da seguinte maneira:
"hardware/pci_bus/ide_adapter/ide_controller[@id=1]/location[@id=0]/pathname/absolute"
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 |