IsPwrShutdownAllowed function (powrprof.h)

[IsPwrShutdownAllowed is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. See Remarks.]

Determines whether the computer supports the soft off power state.

Syntax

BOOLEAN IsPwrShutdownAllowed();

Return value

If the computer supports soft off (power state S5), the function returns TRUE. Otherwise, the function returns FALSE.

Remarks

This information is also available through the CallNtPowerInformation function. The value is returned in the SystemS5 member of the SYSTEM_POWER_CAPABILITIES structure.

Starting with Windows Vista, computers must support the soft off power state. Therefore, this function is relevant only to Windows Server 2003 and earlier operating systems.

For more information on using PowrProf.h, see Power Schemes.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header powrprof.h
Library PowrProf.lib
DLL PowrProf.dll

See also

CallNtPowerInformation

Power Management Functions

SYSTEM_POWER_CAPABILITIES