Método RequestStateChange de la clase CIM_LANEndpoint
Solicita que el estado del elemento se cambie al valor especificado en el parámetro RequestedState. Cuando tenga lugar el cambio de estado solicitado, los valores EnabledState y RequestedState del elemento serán iguales. Invocar el método RequestChangeState varias veces podría dar lugar a que las solicitudes anteriores se sobrescriban o se pierdan. Si se devuelve 0, la tarea se ha completado correctamente y el uso de ConcreteJob no ha sido necesario. Si se devuelve 4096 (0x1000), la tarea tardará algún tiempo en completarse, ConcreteJob se creará y se devolverá su referencia en el parámetro de salida Job. Cualquier otro código de retorno indica una condición de error.
Sintaxis
uint32 RequestStateChange(
[in] uint16 RequestedState,
[out] CIM_ConcreteJob Job,
[in] datetime TimeoutPeriod
);
Parámetros
-
RequestedState [entrada]
-
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 ("Se ha completado sin errores"), 3 ("Tiempo de expiración") o 4096 (0x1000) ("Trabajo iniciado"). Consulte la descripción de las propiedades EnabledState y RequestedState para obtener las explicaciones detalladas de los valores de RequestedState.
-
Enabled (2)
-
Disabled (3)
-
Apagar (4)
-
Sin conexión (6)
-
Probar (7)
-
Fraccionar (8)
-
Poner en modo inactivo (9)
-
Arrancar (10)
-
Restablecer (11)
-
Reservado por DMTF (12 32767)
-
Reservado por el proveedor (32768 65535)
-
-
Job [out]
-
Una clase CIM_ConcreteJob que contiene una referencia al trabajo (puede ser null si se ha completado la tarea).
-
TimeoutPeriod [entrada]
-
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 se debe usar 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 ni null y la implementación no admite este parámetro, se debe devolver el código de retorno "No se admite el uso del parámetro de tiempo de expiración".
Valor devuelto
-
Completado sin errores (0)
-
Not Supported (1)
-
Error desconocido o sin especificar (2)
-
No se puede completar en el período de tiempo de expiración (3)
-
Con error (4)
-
Parámetro no válido (5)
-
En uso (6)
-
Reservado por DMTF (7 4095)
-
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 de tiempo de expiración (4098)
-
Ocupado (4099)
-
Método reservado (4100 32767)
-
Específico del proveedor (32768 65535)
Requisitos
| Cliente mínimo compatible |
Windows 8 |
| Servidor mínimo compatible |
Windows Server 2012 |
| Espacio de nombres |
Root\standardcimv2 |
| MOF |
|
| Archivo DLL |
|