Método IVMVirtualMachine::SetConfigurationValue

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

Define o valor da configuração especificada para essa VM (máquina virtual).

Sintaxe

HRESULT SetConfigurationValue(
  [in] BSTR    configurationKey,
  [in] VARIANT configurationValue
);

Parâmetros

configurationKey [in]

A chave usada para identificar o valor de configuração como armazenado no arquivo "*.vmc".

Importante

As alterações devem ser feitas em "*.vmc" usando apenas o método SetConfigurationValue . Não há suporte para a alteração de "*.vmc" usando qualquer outro método.

configurationValue [in]

O valor de configuração. Esse valor cay é um dos seguintes tipos VARIANT : VT_ARRAY|VT_UI1 (bytes brutos), VT_BSTR (cadeia de caracteres), VT_UI4 (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 ou o parâmetro configurationValue não é um tipo variante válido.
VM_E_VM_UNKNOWN 0xA0040207	A configuração é desconhecida.
DISP_E_EXCEPTION 0x80020009	Ocorreu um erro inesperado.

Comentários

Os valores a seguir têm suporte para o parâmetro configurationKey .

configurationKey value	Descrição	Tipo de dados	Valor padrão
"hardware/bios/time_sync_at_boot"	"true" se o relógio CMOS da VM for sincronizado com o relógio host na inicialização; Caso contrário, "false".	"boolean"	"true"
"integration/microsoft/host_time_sync/enabled""	"true" se a sincronização de tempo de host estiver habilitada nos componentes de integração; Caso contrário, "false".	"boolean"	"true"
"ui_options/auto_app_publish"	"true" se a publicação automática de aplicativos estiver habilitada nos componentes de integração; Caso contrário, "false". Isso também é chamado de aplicativos virtuais.	"boolean"	"true"
"ui_options/seconds_to_save"	Número de segundos para aguardar antes de salvar a VM depois que todos os aplicativos forem fechados. No entanto, valores abaixo de 20 e mais de 4.294.968 têm significados especiais. Para obter detalhes, confira a lista a seguir 0 Nunca salve a VM. 1 20 Aguarde 20 segundos antes de salvar a VM. 21 4,294,967 Aguarde o número especificado de segundos antes de salvar a VM. 4,294,968 4,294,967,295 Aguarde 4.294.968 segundos antes de salvar a VM.	"inteiro"	300

Esse método fornece acesso de baixo nível a qualquer valor de configuração. Ele pode ser usado para definir valores de configuração para chaves definidas pelo cliente. Tenha cuidado se você usar esse método para definir valores de configuração do sistema, pois nenhuma verificação de erro é executada no valor de configuração. Além disso, alguns valores de configuração 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 definir o valor da chave "ram_size" localizada na seguinte árvore de chaves:

<preferences>
  <hardware>
    <bios>
      <time_sync_at_boot type="boolean">true</time_sync_at_boot>

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 definir o valor da chave "golf" localizada na seguinte árvore de chaves:

<preferences>
  <alpha>
    <bravo>
      <charlie>
        <delta id="1">
          <echo id="0">
            <foxtrot>
              <golf type="string">D</golf>

A cadeia de caracteres de caminho configurationKey seria especificada da seguinte maneira:

"alpha/bravo/charlie/delta[@id=1]/echo[@id=0]/foxtrot/golf"

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

IVMVirtualPC::SetConfigurationValue