Método SetPowerState de la clase CIM_LogicalDevice (proveedores WMI CIMWin32)
El método SetPowerState de la clase CIM_LogicalDevice establece el estado de energía deseado para un dispositivo lógico y cuándo se debe colocar un dispositivo en ese estado.
Importante
Las clases CIM (Grupo de tareas de administración distribuida) DMTF (Common Information Model) son las clases primarias en las que se compilan las clases WMI. WMI actualmente solo admite los esquemas de versión cim 2.x.
Sintaxis
uint32 SetPowerState(
[in] uint16 PowerState,
[in] datetime Time
);
Parámetros
-
PowerState [in]
-
Valor ValueMap que especifica el estado de energía deseado para este dispositivo lógico.
-
Potencia completa (1)
-
Potencia completa.
-
Ahorro de energía: modo de bajo consumo (2)
-
Ahorro de energía en modo de bajo consumo.
-
Ahorro de energía: en espera (3)
-
Ahorro de energía en espera.
-
Ahorro de energía - Otros (4)
-
Ahorro de energía otros.
-
Ciclo de alimentación (5)
-
Ciclo de energía.
-
Apagado (6)
-
Apagar.
Hora [en]
Especifica cuándo se debe establecer el estado de energía, ya sea como un valor de fecha y hora normal o como un valor de intervalo (donde comienza el intervalo cuando se recibe la invocación del método). Cuando el parámetro PowerState es igual a 5 ("Ciclo de energía"), el parámetro Time indica cuándo debe encenderse el dispositivo de nuevo. El apagado es inmediato.
Valor devuelto
Devuelve 0 (cero) si se ejecuta correctamente, 1 (uno) si no se admite la solicitud PowerState y Time especificada, y otro valor si se produjo algún otro error.
Comentarios
En una subclase, se debe especificar el conjunto de códigos de retorno posibles mediante un calificador ValueMap en el método . Las cadenas a las que se traduce el contenido de ValueMap también deben especificarse en la subclase como calificador de matriz Values . Este método se hereda de CIM_LogicalDevice.
Actualmente, WMI no implementa este método. Para usar este método, debe implementarlo en su propio proveedor.
Esta documentación se deriva de las descripciones de clase CIM publicadas por DMTF. Microsoft puede haber realizado cambios para corregir errores menores, cumplir los estándares de documentación de Microsoft SDK o proporcionar más información.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|