PBT_APMQUERYSUSPENDFAILED event

[PBT_APMQUERYSUSPENDFAILED is available for use in the operating systems specified in the Requirements section. Support for this event was removed in Windows Vista. Use SetThreadExecutionState instead.]

Notifies applications that permission to suspend the computer was denied. This event is broadcast if any application or driver returned BROADCAST_QUERY_DENY to a previous PBT_APMQUERYSUSPEND event.

A window receives this event through the WM_POWERBROADCAST message. The wParam and lParam parameters are set as described following.

LRESULT 
CALLBACK 
WindowProc( HWND   hwnd,    // handle to window
            UINT   uMsg,    // WM_POWERBROADCAST
            WPARAM wParam,  // PBT_APMQUERYSUSPENDFAILED
            LPARAM lParam); // zero

Parameters

hwnd

A handle to a window.

uMsg

Value	Meaning
WM_POWERBROADCAST 536 (0x218)	Message identifier.

wParam

Value	Meaning
PBT_APMQUERYSUSPENDFAILED 2 (0x2)	Event identifier.

lParam

Reserved: must be zero.

Return value

No return value.

Remarks

Applications typically respond to this event by resuming normal operation.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
End of client support	Windows XP
End of server support	Windows Server 2003
Header	WinUser.h (include Windows.h)

See also

• Power Management
• Power Management Events
• PBT_APMQUERYSUSPEND
• WM_POWERBROADCAST