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 |
|
| Archivo DLL |
|