Método RequestStateChange de la clase Msvm_ConcreteJob

Solicita que el estado del trabajo se cambie al estado especificado. Invocar el método RequestStateChange varias veces puede provocar que las solicitudes anteriores se sobrescriban o se pierdan. Si se devuelve 0, la tarea se completó correctamente. Cualquier otro código de retorno indica una condición de error.

Sintaxis

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

Parámetros

RequestedState [in]

Tipo: uint16

Nuevo estado de un trabajo.

Inicio (2)

Cambia el estado a "Running".

Suspender (3)

Detiene el trabajo temporalmente. La intención es reiniciar posteriormente el trabajo con "Start". Es posible especificar el estado "Servicio" mientras está suspendido. (Esto es específico del trabajo).

Finalizar (4)

Detiene el trabajo de forma limpia, guardando los datos, conservando el estado y cerrando todos los procesos subyacentes de forma ordenada.

Matar (5)

Finaliza el trabajo inmediatamente sin necesidad de guardar datos ni conservar el estado.

Servicio (6)

Coloca el trabajo en un estado de servicio específico del proveedor. Es posible reiniciar el trabajo.

DmTF reservado

Reservado.

Proveedor reservado

Reservado.

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.

Completado sin error (0)

No compatible (1)

Error desconocido o no especificado (2)

No se puede completar en el período de tiempo de espera (3)

Error (4)

Parámetro no válido (5)

En uso (6)

DMTF Reservado (7 4095)

Parámetros del método activados: 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)

Comentarios

El acceso a la clase Msvm_ConcreteJob puede estar restringido por el filtrado de UAC. Para obtener más información, vea Control de cuentas de usuario y WMI.

Requisitos

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

Consulte también

Msvm_ConcreteJob