IvMVirtualMachine::GetConfigurationValue (método)

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

Recupera el valor de la configuración especificada para esta máquina virtual.

Sintaxis

HRESULT GetConfigurationValue(
  [in]          BSTR    configurationKey,
  [out, retval] VARIANT *configurationValue
);

Parámetros

configurationKey [in]

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

configurationValue [out, retval]

El valor de configuración. Este valor puede ser uno de los siguientes tipos VARIANT: VT_ARRAY VT_UI1| (bytes sin formato), VT_BSTR (cadena), VT_I4 (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.
E_POINTER 0x80004003	El parámetro configurationValue es NULL.
VM_E_VM_UNKNOWN 0xA0040207	La configuración es desconocida.
VM_E_PREF_NOT_FOUND 0xA0040300	No se encontró la preferencia.
DISP_E_EXCEPTION 0x80020009	Se produjo un error inesperado.

Comentarios

Este método proporciona acceso de bajo nivel a cualquier valor de configuración. Se puede usar para leer los valores de configuración de las claves definidas por el cliente.

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 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 de marca de barra diagonal.

Por ejemplo, para leer el valor de la clave "ram_size" ubicada en el árbol de claves siguiente:

<hardware>
    <memory>
        <ram_size type="integer">128</ram_size>

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 insertan en la cadena de ruta de acceso configurationKey inmediatamente después de su clave de configuración asociada mediante el siguiente formato entre corchetes: "[@id="id_value"]".

Por ejemplo, para leer el valor de la clave "absoluta" ubicada en el árbol de claves siguiente:

<hardware>
    <pci_bus>
        <ide_adapter>
            <ide_controller id="1">
                <location id="0">
                    <pathname>
                        <absolute type="string">D</absolute>

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

"hardware/pci_bus/ide_adapter/ide_controller[@id=1]/location[@id=0]/pathname/absolute"

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