PBT_APMQUERYSUSPEND
The
PBT_APMQUERYSUSPEND message is sent to request permission to suspend the
computer. An application that grants permission should carry out preparations
for the suspension before returning. A window receives this message through the
WM_POWERBROADCAST
message.
Flags = (DWORD) lParam;
Parameters
Flags
Action flags.
If bit 0 is 1, the application can prompt the user for directions on how to
prepare for the suspension; otherwise, the application must prepare without
user interaction. All other bit values are reserved.
Return Values
Return TRUE
to grant the request to suspend. To deny the request, return
BROADCAST_QUERY_DENY.
Remarks
An
application should process this message by first determining whether permission
to suspend can be granted. It must not grant permission if doing so would cause
a loss of data. The application can prompt the user for directions on how to
prepare for suspension only if bit 0 in the Flags parameter is set.
See Also