IVMVirtualMachine::RemoveConfigurationValue (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)].
Quita el valor de la configuración especificada para esta máquina virtual.
Sintaxis
HRESULT RemoveConfigurationValue(
[in] BSTR configurationKey
);
Parámetros
-
configurationKey [in]
-
Clave usada para identificar el valor de configuración tal y como se almacena en el archivo "*.vmc".
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 es NULL o está vacío. |
|
La configuración es desconocida. |
|
No se encontró la preferencia. |
|
Se produjo un error inesperado. |
Comentarios
Este método proporciona acceso de bajo nivel a cualquier valor de configuración. Se puede usar para quitar los valores de configuración de las claves definidas por el cliente. Tenga cuidado si usa este método para quitar los valores de configuración del sistema, ya que algunos valores 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 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 quitar 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 quitar 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 |
|
| IID |
IID_IVMVirtualMachine se define como f7092aa1-33ed-4f78-a59f-c00adfc2edd7 |