Método RequestStateChange de la clase CIM_EnabledLogicalElement
Solicita que el estado del elemento se cambie al valor especificado en el parámetro RequestedState. Cuando se produzca el cambio de estado solicitado, EnabledState y RequestedState del elemento serán los mismos. Invocar el método RequestStateChange varias veces podría dar lugar a que las solicitudes anteriores se sobrescriban o pierdan.
Sintaxis
uint32 RequestStateChange(
[in] uint16 RequestedState,
[out] CIM_ConcreteJob REF Job,
[in] datetime TimeoutPeriod
);
Parámetros
-
RequestedState [in]
-
Estado solicitado para el elemento. Esta información se colocará en la propiedad RequestedState de la instancia si el código de retorno del método RequestStateChange es 0 ('Completed with No Error') o 4096 (0x1000) ('Job Started'). Consulte la descripción de las propiedades EnabledState y RequestedState para obtener las explicaciones detalladas de los valores RequestedState .
-
Inicio (2)
-
Cambia el estado a "En ejecución".
-
Suspender (3)
-
Detiene el trabajo temporalmente. La intención es reiniciar posteriormente el trabajo con "Start". Es posible especificar el estado "Servicio" mientras se suspende. (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 Reserved (7..32767)
-
Proveedor reservado (32768..65535)
Trabajo [salida]
Puede contener una referencia al CIM_ConcreteJob creado para realizar un seguimiento de la transición de estado iniciada por la invocación 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
Devuelve un 0 si se realiza correctamente; de lo contrario, devuelve un error.
-
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 Reserved (..)
-
Parámetros de método comprobados: trabajo iniciado (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 |
|