Compartir a través de

IVMGuestOS::SetParameter (método)

  • 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 un parámetro con nombre dentro del sistema operativo invitado.

Sintaxis

HRESULT SetParameter(
  [in] BSTR inParameterName,
  [in] BSTR inParameterValue
);

Parámetros

inParameterName [in]

El nombre del parámetro. Debe tener entre 1 y 255 caracteres de longitud y no puede contener un carácter de barra diagonal inversa (\).

inParameterValue [in]

Valor del parámetro.

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
 Un parámetro no es válido o no se especifica.
VM_E_TIMED_OUT
0xA0040202
 La operación no se completó de forma oportuna.
VM_E_VM_NOT_RUNNING
0xA0040206
 La máquina virtual (VM) no se está ejecutando.
VM_E_VM_PAUSED
0xA00400507
 La máquina virtual está en pausa.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 Los componentes de integración no están instalados en esta máquina virtual.
DISP_E_EXCEPTION
0x80020009
 Se produjo un error inesperado.

Observaciones

La máquina virtual debe estar en ejecución y los componentes de integración deben instalarse cuando se invoca este método. Este método solo se admite para los sistemas operativos invitados basados en Windows.

Con los componentes de integración instalados, la siguiente clave se agrega automáticamente al registro del sistema operativo invitado:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Virtual Machine\Guest\Parameters

Cuando se inicia el sistema operativo invitado, los siguientes valores de cadena del Registro se rellenan en la clave Parameters :

  • HostName
  • PhysicalHostName
  • PhysicalHostNameFullyQualified
  • VirtualMachineName

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_IVMGuestOS se define como 99fea0db-4880-499a-b6d8-73dff9bc91be

Vea también

IVMGuestOS