Método IVMVirtualPC::SetConfigurationValue
[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).]
Define o valor da definição de configuração especificada.
Sintaxe
HRESULT SetConfigurationValue(
[in] BSTR preferenceKey,
[in] VARIANT preferenceValue
);
Parâmetros
-
preferenceKey [in]
-
A chave usada para identificar a preferência, conforme armazenada no arquivo de configuração por usuário (Options.xml em "%LocalAppData%\Microsoft\Windows Virtual PC").
Importante
As alterações devem ser feitas em Options.xml usando apenas o método SetConfigurationValue . Não há suporte para alterar Options.xml usando qualquer outro método.
-
preferenceValue [in]
-
O valor de preferência. Esse valor pode ser 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.
| Código/valor de retorno | Descrição |
|---|---|
|
A operação foi bem-sucedida. |
|
O parâmetro preferenceKey ou preferenceValue é NULL. |
|
O parâmetro preferenceKey não é válido ou é uma cadeia de caracteres vazia. |
|
Ocorreu um erro inesperado. |
|
O usuário atual não tem acesso suficiente ao arquivo de configuração. |
|
O processador não dá suporte a extensões HAV (Virtualização Acelerada por Hardware). |
Comentários
Os valores a seguir têm suporte para o parâmetro preferenceKey .
| valor preferenceKey | Descrição | Tipo de dados | Valor padrão |
|---|---|---|---|
| "idle_timeout" |
Número de segundos que vpc.exe deve aguardar antes de sair se não houver VMs ou aplicativos ativos usando as Interfaces de PC Virtual do Windows. |
"inteiro" |
"30" |
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 uma máquina virtual está em execução.
As chaves de configuração estão localizadas no arquivo "Options.xml" 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 "idle_timeout" localizada na seguinte árvore de chaves:
<preferences>
<idle_timeout type="integer">60</idle_timeout>
A cadeia de caracteres de caminho preferenceKey seria especificada da seguinte maneira:
"idle_timeout"
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 preferenceKey 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 preferenceKey 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 |
|
| IID |
IID_IVMVirtualPC é definido como 236ba0d9-a24a-4292-a132-27c1421dfd01 |