Método IVMVirtualMachine::SetActivationValue

  • Artículo

[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 de activación especificada para esta máquina virtual.

Sintaxis

HRESULT SetActivationValue(
  [in] BSTR    activationKey,
  [in] VARIANT activationValue
);

Parámetros

activationKey [in]

Clave usada para identificar el valor de activación tal y como se almacena en el archivo "*.vmc".

activationValue [in]

Valor de activación. 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
S_OK
0
 La operación se realizó correctamente.
E_INVALIDARG
0x80000003
 El parámetro activationKey es NULL o está vacío, o el parámetro activationValue no es un tipo de variante válido.
VM_E_VM_UNKNOWN
0xA0040207
 La configuración es desconocida.
VM_E_PREF_NOT_FOUND
0xA0040300
 La configuración no tiene ninguna activación válida.
DISP_E_EXCEPTION
0x80020009
 Se produjo un error inesperado.

Observaciones

Este método proporciona acceso de bajo nivel a cualquier valor de activación. Se puede usar para establecer valores de activación para claves definidas por el cliente. Tenga cuidado si usa este método para establecer valores de activación del sistema, ya que no se realiza ninguna comprobación de errores en el valor de activación. Además, algunos valores de activación no se pueden cambiar mientras se ejecuta la máquina virtual. Cuando se inicia una máquina virtual, se realiza una copia de sus valores de configuración, que se convierte en su conjunto de valores de activación. Los valores de activación se mantienen hasta que se apaga o reinicia la máquina virtual. Tenga en cuenta que Windows Virtual PC solo puede usar la configuración para almacenar valores para determinadas claves, es decir, el valor de activación nunca se puede usar.

Nota

La sesión de máquina virtual debe ejecutarse antes de que se puedan cambiar los valores de activación.

Las claves de activación se almacenan internamente de forma jerárquica 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 "default_action" ubicada en el árbol de claves siguiente:

<settings>
    <undo_drives>
        <default_action type="integer">1</default_action>

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

"settings/undo_drives/default_action"

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

Vea también

IVMVirtualMachine