Método IVMVirtualMachine::SetConfigurationValue

Artículo
06/13/2023

[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 para esta máquina virtual (VM).

Sintaxis

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

Parámetros

configurationKey [in]: Clave usada para identificar el valor de configuración tal y como se almacena en el archivo "*.vmc".

Importante

Los cambios deben realizarse en "*.vmc" solo mediante el método SetConfigurationValue . No se admite el cambio de "*.vmc" mediante cualquier otro método.
configurationValue [in]: El valor de configuración. Este valor debe 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
S_OK 0	La operación se realizó correctamente.
E_INVALIDARG 0x80000003	El parámetro configurationKey es NULL o está vacío o el parámetro configurationValue no es un tipo de variante válido.
VM_E_VM_UNKNOWN 0xA0040207	La configuración es desconocida.
DISP_E_EXCEPTION 0x80020009	Se produjo un error inesperado.

Observaciones

Se admiten los siguientes valores para el parámetro configurationKey .

valor configurationKey	Descripción	Tipo de datos	Valor predeterminado
"hardware/bios/time_sync_at_boot"	"true" si el reloj CMOS de la máquina virtual se va a sincronizar con el reloj del host en el arranque; De lo contrario, "false".	"boolean"	"true"
"integration/microsoft/host_time_sync/enabled""	"true" si la sincronización de hora del host está habilitada en los componentes de integración; De lo contrario, "false".	"boolean"	"true"
"ui_options/auto_app_publish"	"true" si la publicación automática de aplicaciones está habilitada en los componentes de integración; De lo contrario, "false". Esto también se denomina aplicaciones virtuales.	"boolean"	"true"
"ui_options/seconds_to_save"	Número de segundos que hay que esperar antes de guardar la máquina virtual después de cerrar todas las aplicaciones. Sin embargo, los valores inferiores a 20 y más de 4.294.968 tienen significados especiales. Para obtener más información, consulte la lista siguiente. 0 No guarde nunca la máquina virtual. 1 20 Espere 20 segundos antes de guardar la máquina virtual. 21 4,294,967 Espere el número de segundos especificado antes de guardar la máquina virtual. 4,294,968 4,294,967,295 Espere 4 294 968 segundos antes de guardar la máquina virtual.	"entero"	300

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 la máquina virtual.

Las claves de configuración se encuentran en el archivo "*.vmc" 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 "ram_size" ubicada en el árbol de claves siguiente:

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

La cadena de ruta de acceso configurationKey se especificaría de la siguiente manera:

"hardware/memory/ram_size"

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 configurationKey inmediatamente después de su clave de configuración asociada con 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 configurationKey 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	VPCCOMInterfaces.h
IID	IID_IVMVirtualMachine se define como f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Consulte también

IVMVirtualMachine
IVMVirtualPC::SetConfigurationValue

Compartir a través de