método Msvm_GuestServiceInterfaceComponent::RequestStateChange

Solicita que se cambie el estado del componente de interfaz de servicio invitado al valor especificado.

Sintaxis

uint32 RequestStateChange(
  [in]  uint16              RequestedState,
  [out] CIM_ConcreteJob Job,
  [in]  datetime            TimeoutPeriod
);

Parámetros

RequestedState [in]

Tipo: uint16

El nuevo estado. La información se coloca en la propiedad RequestedState de la instancia si el código devuelto del método RequestStateChange es 0 o 4096. Para obtener más información, consulta la descripción de las propiedades EnabledState y RequestedState del elemento. Debe ser uno de los siguientes valores.

Habilitado (2)

Deshabilitado (3)

Apagar (4)

Sin conexión (6)

Prueba (7)

Aplazar (8)

Quiesce (9)

Reinicio (10)

Restablecimiento (11)

DMTF Reserved (..)

Proveedor reservado (32768..65535)

Trabajo [salida]

Tipo: CIM_ConcreteJob

Referencia opcional a un objeto Msvm_ConcreteJob que se devuelve si la operación se ejecuta de forma asincrónica. Si está presente, la referencia devuelta se puede usar para supervisar el progreso y obtener el resultado del método .

TimeoutPeriod [in]

Tipo: datetime

Período de tiempo de espera que especifica la cantidad máxima de tiempo que el cliente espera que tarde la transición al nuevo estado. El formato de intervalo debe usarse para especificar el período de tiempo de espera. Un valor de 0 o Null indica que el cliente no tiene requisitos de tiempo para la transición. Si esta propiedad no contiene 0 o Null y la implementación no admite este parámetro, se debe devolver un código de retorno de 4098 (uso del parámetro timeout no admitido).

Valor devuelto

Tipo: uint32

Este método devuelve uno de los valores siguientes.

Código o valor devuelto	Descripción
Completado sin error 0	Correcto.
No compatible 1
Error desconocido o no especificado 2
NO se puede completar dentro del período de tiempo de espera 3
Erróneo 4
Parámetro no válido 5
En uso 6
DMTF Reserved ..
Parámetros de método comprobados: transición iniciada 4096
Transición de estado no válida 4097
No se admite el uso del parámetro timeout 4098
Ocupado 4099
Método reservado 4100..32767
Específico del proveedor 32768..65535

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8.1 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 R2 [solo aplicaciones de escritorio]
Espacio de nombres	\\Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
Archivo DLL	Vmms.exe

Consulte también

Msvm_GuestServiceInterfaceComponent