Método RequestStateChange de la clase CIM_ConcreteJob
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 |
|
| Archivo DLL |
|