Método IVMVirtualPC::SetConfigurationValue
[Windows Virtual PC ya no está disponible para su uso a partir de Windows 8. En su lugar, use el proveedor WMI de Hyper-V (V2).]
Establece el valor de la configuración especificada.
Sintaxis
HRESULT SetConfigurationValue(
[in] BSTR preferenceKey,
[in] VARIANT preferenceValue
);
Parámetros
-
preferenceKey [in]
-
Clave usada para identificar la preferencia, tal como se almacena en el archivo de configuración por usuario (Options.xml en "%LocalAppData%\Microsoft\Windows Virtual PC").
Importante
Los cambios deben realizarse en Options.xml solo con el método SetConfigurationValue . No se admite el cambio de Options.xml con cualquier otro método.
-
preferenceValue [in]
-
Valor de preferencia. Este valor puede ser uno de los siguientes tipos VARIANT : VT_ARRAY|VT_UI1 (bytes sin formato), VT_BSTR (cadena), VT_UI4 (entero) o VT_BOOL (booleano).
Valor devuelto
Este método puede devolver uno de estos valores.
| Código o valor devuelto | Descripción |
|---|---|
|
La operación se realizó correctamente. |
|
El parámetro preferenceKey o preferenceValue es NULL. |
|
El parámetro preferenceKey no es válido o es una cadena vacía. |
|
Se produjo un error inesperado. |
|
El usuario actual no tiene acceso suficiente al archivo de configuración. |
|
El procesador no admite extensiones de virtualización acelerada de hardware (HAV). |
Comentarios
Se admiten los siguientes valores para el parámetro preferenceKey .
| valor preferenceKey | Descripción | Tipo de datos | Valor predeterminado |
|---|---|---|---|
| "idle_timeout" |
Número de segundos que vpc.exe deben esperar antes de salir si no hay ninguna máquina virtual o aplicaciones activas que usen las interfaces de PC virtual Windows. |
"entero" |
"30" |
Este método proporciona acceso de bajo nivel a cualquier valor de configuración. Se puede usar para establecer valores de configuración para claves definidas por el cliente. Tenga cuidado si usa este método para establecer valores de configuración del sistema, ya que no se realiza ninguna comprobación de errores en el valor de configuración. Además, algunos valores de configuración no se pueden cambiar mientras se ejecuta una máquina virtual.
Las claves de configuración se encuentran en el archivo "Options.xml" de la máquina virtual en formato XML. Las claves se almacenan de forma jerárquica de forma similar a las claves del Registro en Windows. Para especificar una subclave específica, se construye una "ruta de acceso de clave" que especifica las distintas claves en un formato delimitado por una barra diagonal.
Por ejemplo, para establecer el valor de la clave "idle_timeout" ubicada en el árbol de claves siguiente:
<preferences>
<idle_timeout type="integer">60</idle_timeout>
La cadena de ruta de acceso preferenceKey se especificaría de la siguiente manera:
"idle_timeout"
Si alguna de las claves del árbol deseado tiene un valor de atributo "id", el atributo y su valor se incrustan en la cadena de ruta de acceso preferenceKey inmediatamente después de su clave de configuración asociada mediante el siguiente formato entre corchetes: "[@id="id_value"]".
Por ejemplo, para establecer el valor de la clave "golf" ubicada en el árbol de claves siguiente:
<preferences>
<alpha>
<bravo>
<charlie>
<delta id="1">
<echo id="0">
<foxtrot>
<golf type="string">D</golf>
La cadena de ruta de acceso preferenceKey se especificaría de la siguiente manera:
"alpha/bravo/charlie/delta[@id=1]/echo[@id=0]/foxtrot/golf"
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
No se admite ninguno |
| Fin de compatibilidad de cliente |
Windows 7 |
| Producto |
Windows Virtual PC |
| Encabezado |
|
| IID |
IID_IVMVirtualPC se define como 236ba0d9-a24a-4292-a132-27c1421dfd01 |