Método RequestStateChange de la clase WMI de 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 RequestChangeState varias veces podría provocar que las solicitudes anteriores se sobrescriban o se pierdan. Si se devuelve 0, la tarea se completó correctamente y no se requería el uso de ConcreteJob. Si se devuelve 4096 (0x1000), la tarea tardará algún tiempo en completarse, se creará ConcreteJob y se devolverá su referencia en el parámetro de salida Job. Cualquier otro código devuelto indica una condición de error.
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 devuelto del método RequestStateChange es 0 ("Completed with No Error", 3 ("Timeout") o 4096 (0x1000) ("Job Started"). Consulte la descripción de las propiedades EnabledState y RequestedState para obtener las explicaciones detalladas de los valores de RequestedState.
-
habilitado (2)
-
deshabilitado (3)
-
apagar (4)
-
sin conexión (6)
-
test (7)
-
aplazar (8)
-
quiesce (9)
-
reinicio (10)
-
restablecer (11)
-
reservado de DMTF (12 32767)
-
proveedor reservado (32768 65535)
-
-
de trabajo [out]
-
Un CIM_ConcreteJob que contiene una referencia al trabajo (puede ser NULL si se completa la tarea).
-
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 este período. Un valor de 0 o un parámetro 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 devuelto de "Use Of Timeout Parameter Not Supported".
Valor devuelto
-
completado sin de error (0)
-
no compatibles (1)
-
error desconocido o no especificado (2)
-
No se puede completar en el período de tiempo de espera (3)
-
error (4)
-
de parámetros no válidos (5)
-
En uso (6)
-
dmTF reserved (7 4095)
-
Parámetros del método comprobados: iniciado por el trabajo (4096)
-
de transición de estado no válida (4097)
-
uso del parámetro timeout no admitido (4098)
-
ocupado (4099)
-
método reservado (4100 32767)
-
específicos del proveedor (32768 65535)
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo admitido |
Windows 8 |
| Servidor mínimo admitido |
Windows Server 2012 |
| Namespace |
Root\standardcimv2 |
| MOF |
|
| DLL |
|