Share via


GetSystemPowerState (Windows Embedded CE 6.0)

1/6/2010

This function returns the current system power state.

Syntax

DWORD GetSystemPowerState(
  LPWSTR pBuffer,
  DWORD Length,
  PDWORD pFlags
);

Parameters

  • pBuffer
    [out] Buffer to receive the system power state name.
  • Length
    [in] Length of pBuffer in characters.
  • pFlags
    [out] Optional. Receives the system power state flags, which is the bitwise-OR of the POWER_STATE_XXX flags defined in the Pm.h header file. This parameter can be NULL.

    The following table shows the POWER_STATE_XXX flags.

    Flag Description

    POWER_STATE_BOOT

    Boot state

    POWER_STATE_CRITICAL

    Critical state

    POWER_STATE_IDLE

    Idle state

    POWER_STATE_OFF

    Off state

    POWER_STATE_ON

    On state

    POWER_STATE_PASSWORD

    Password protected power state.

    POWER_STATE_RESET

    Reset state

    POWER_STATE_SUSPEND

    Suspended state

Return Value

  • ERROR_INSUFFICIENT_BUFFER
    Indicates that the buffer is too small.
  • ERROR_NOT_FOUND
    Indicates an unknown error.
  • ERROR_SUCCESS
    Indicates success.
  • Win32 error code
    Used for all other errors.

See Also

Concepts

Power States

Other Resources

Power Management Functions