Função RegisterSuspendResumeNotification (winuser.h)
Registra-se para receber notificação quando o sistema é suspenso ou retomado. Semelhante a PowerRegisterSuspendResumeNotification, mas opera no modo de usuário e pode usar um identificador de janela.
Sintaxe
HPOWERNOTIFY RegisterSuspendResumeNotification(
[in] HANDLE hRecipient,
[in] DWORD Flags
);
Parâmetros
[in] hRecipient
Esse parâmetro contém parâmetros para assinar uma notificação de energia ou um identificador de janela que representa o processo de assinatura.
Se Flags for DEVICE_NOTIFY_CALLBACK, hRecipient será interpretado como um ponteiro para uma estrutura DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS . Nesse caso, a função de retorno de chamada é DeviceNotifyCallbackRoutine. Quando a função retorno de chamada é executada, o parâmetro Type é definido indicando o tipo de evento que ocorreu. Os valores possíveis incluem PBT_APMSUSPEND, PBT_APMRESUMESUSPEND e PBT_APMRESUMEAUTOMATIC – consulte Eventos de Gerenciamento de Energia para obter mais informações. O parâmetro Setting não é usado com notificações de suspensão/retomada.
Se Flags for DEVICE_NOTIFY_WINDOW_HANDLE, hRecipient será um identificador para a janela para a qual entregar eventos.
[in] Flags
Esse parâmetro pode ser DEVICE_NOTIFY_WINDOW_HANDLE ou DEVICE_NOTIFY_CALLBACK.
Retornar valor
Um identificador para o registro. Use esse identificador para cancelar o registro de notificações.
Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winuser.h |
| Biblioteca | User32.lib |
| DLL | User32.dll |
| Conjunto de APIs | ext-ms-win-ntuser-powermanagement-l1-1-0 (introduzido em Windows 8) |
Confira também
DEVICE_NOTIFY_CALLBACK_ROUTINE