Función SetSuspendState (powrprof.h)

Suspende el sistema apagando la alimentación. Dependiendo del parámetro Hibernate , el sistema entra en un estado de suspensión (suspensión) o hibernación (S4).

Sintaxis

BOOLEAN SetSuspendState(
  [in] BOOLEAN bHibernate,
  [in] BOOLEAN bForce,
  [in] BOOLEAN bWakeupEventsDisabled
);

Parámetros

[in] bHibernate

Si este parámetro es TRUE, el sistema hiberna. Si el parámetro es FALSE, el sistema se suspende.

[in] bForce

Este parámetro no produce resultado alguno.

[in] bWakeupEventsDisabled

Si este parámetro es TRUE, el sistema deshabilita todos los eventos de reactivación. Si el parámetro es FALSE, los eventos de reactivación del sistema permanecen habilitados.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

El proceso de llamada debe tener el privilegio SE_SHUTDOWN_NAME . Para habilitar el privilegio SE_SHUTDOWN_NAME , use la función AdjustTokenPrivileges . Para obtener más información, consulte Cambio de privilegios en un token.

Una aplicación puede usar SetSuspendState para realizar la transición del sistema desde el estado de trabajo al estado en espera (suspensión) o, opcionalmente, hibernar (S4). Esta función es similar a la función SetSystemPowerState .

Para obtener más información sobre el uso de PowrProf.h, consulte Esquemas de energía. Para obtener información sobre los eventos que pueden reactivar el sistema, consulte Eventos de reactivación del sistema.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	powrprof.h
Library	PowrProf.lib
Archivo DLL	PowrProf.dll

Consulte también

PBT_APMQUERYSUSPEND

PBT_APMSUSPEND

Funciones de administración de energía