Evento PBT_APMSUSPEND

  • Artigo

Notifica os aplicativos de que o computador está prestes a entrar em um estado suspenso. Esse evento normalmente é transmitido quando todos os aplicativos e drivers instaláveis retornaram TRUE para um evento PBT_APMQUERYSUSPEND anterior.

Uma janela recebe esse evento por meio da mensagem WM_POWERBROADCAST. Os parâmetros wParam e lParam são definidos conforme descrito a seguir.

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

Parâmetros

hwnd

Um identificador para uma janela.

uMsg

Valor Significado
WM_POWERBROADCAST
536 (0x218)
 Identificador de mensagem.

wParam

Valor Significado
PBT_APMSUSPEND
4 (0x4)
 Identificador de evento.

lParam

Reservado, precisa ser zero.

Valor retornado

Sem valor de retorno.

Comentários

Um aplicativo deve processar esse evento concluindo todas as tarefas necessárias para salvar dados.

O sistema oferece aproximadamente dois segundos para que um aplicativo manipule essa notificação. Se um aplicativo ainda estiver executando operações depois que a alocação de tempo dele tiver expirado, o sistema poderá interromper o aplicativo.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
WinUser.h (incluem Windows.h)

Confira também