Compartir a través de

método Msvm_GuestService::RequestStateChange

  • Artículo

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

Sintaxis

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

Parámetros

RequestedState [in]

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]

Referencia opcional a un objeto CIM_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]

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

Este método devuelve uno de los valores siguientes.

Código o valor devuelto Descripción
Completado sin error
0
 Correcto.
No compatible
1
Parámetros de método comprobados: transición iniciada
4096
 La transición es asincrónica.
No se admite el uso del parámetro timeout
4098
Acceso denegado
32769
 Acceso denegado.
Estado no válido para esta operación
32775
 No se admite el valor especificado en el parámetro RequestedState .

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_GuestService