Método IVMVirtualMachine::GetConfigurationValue
[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).]
Recupera o valor da configuração especificada para esta máquina virtual.
Sintaxe
HRESULT GetConfigurationValue(
[in] BSTR configurationKey,
[out, retval] VARIANT *configurationValue
);
Parâmetros
-
configurationKey [in]
-
A chave usada para identificar o valor de configuração como armazenado no arquivo "*.vmc".
-
configurationValue [out, retval]
-
O valor de configuração. Esse valor pode ser um dos seguintes tipos VARIANT : VT_ARRAY|VT_UI1 (bytes brutos), VT_BSTR (cadeia de caracteres), VT_I4 (inteiro) ou VT_BOOL (booliano).
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 configurationKey é NULL ou vazio. |
|
O parâmetro configurationValue é NULL. |
|
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 ler valores de configuração para chaves definidas pelo cliente.
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 ler 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 ler 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 |