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
S_OK 0	A operação foi bem-sucedida.
E_INVALIDARG 0x80000003	O parâmetro configurationKey é NULL ou vazio.
E_POINTER 0x80004003	O parâmetro configurationValue é NULL.
VM_E_VM_UNKNOWN 0xA0040207	A configuração é desconhecida.
VM_E_PREF_NOT_FOUND 0xA0040300	A preferência não foi encontrada.
DISP_E_EXCEPTION 0x80020009	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	VPCCOMInterfaces.h
IID	IID_IVMVirtualMachine é definido como f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Confira também

IVMVirtualMachine