Método SetPowerState de la clase CIM_Controller

El método SetPowerState establece el estado de energía deseado para un dispositivo lógico y cuándo se debe colocar un dispositivo en ese estado. En una subclase, se debe especificar el conjunto de posibles códigos de retorno 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.

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 el dispositivo lógico.

1

Potencia completa.

2

Ahorro de energía en modo de bajo consumo.

3

Ahorro de energía en espera.

4

Ahorra energía.

5

Ciclo de alimentación.

6

Apagar.

Tiempo [in]

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 el dispositivo debe encenderse de nuevo. Apagar es inmediato.

Valor devuelto

Devuelve 0 (cero) si se ejecuta correctamente, 1 (uno) si no se admite la solicitud de PowerState y Time especificada, y otro valor si se produjo algún otro error.

Comentarios

WMI no implementa actualmente este método. Para usar este método, debe implementarlo en su propio proveedor. Para obtener más información, vea Crear proveedores WMI.

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 del SDK de Microsoft 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	CIMWin32.mof
Archivo DLL	CIMWin32.dll

Consulte también

CIM_Controller

CIM_Controller