Método RequestStateChange de la clase CIM_ConcreteJob

Artículo
06/13/2023

Solicita que el estado del trabajo se cambie al valor especificado en el parámetro RequestedState. Invocar el método RequestStateChange varias veces podría dar lugar a 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]: Estado que se va a solicitar para un trabajo. Los valores posibles son los siguientes:
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, guarda los datos, conserva el estado y cierra 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 (7..32767)
Proveedor reservado (32768..65535)

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

Devuelve un 0 si se ejecuta correctamente; de lo contrario, devuelve un error.

Completado sin error (0)
No compatible (1)
Error desconocido o no especificado (2)
NO se puede completar dentro del período de tiempo de espera (3)
Error (4)
Parámetro no válido (5)
En uso (6)
DMTF Reserved (..)
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)

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8.1
Servidor mínimo compatible	Windows Server 2012 R2
Espacio de nombres	Root\virtualization\v2
MOF	WindowsVirtualization.V2.mof
Archivo DLL	Vmms.exe

Consulte también

CIM_ConcreteJob

Share via