evento PBT_APMQUERYSUSPEND

PBT_APMQUERYSUSPEND è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Il supporto per questo evento è stato rimosso in Windows Vista. Usare invece SetThreadExecutionState.

Richiede l'autorizzazione per sospendere il computer. Un'applicazione che concede l'autorizzazione deve eseguire preparativi per la sospensione prima della restituzione.

Una finestra riceve questo evento tramite il messaggio di WM_POWERBROADCAST . I parametri wParam e lParam vengono impostati come descritto di seguito.

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

Parametri

hwnd

Handle per la finestra.

Umsg

wParam

lParam

Flag di azione. Se bit 0 è 1, l'applicazione può richiedere all'utente indicazioni su come prepararsi per la sospensione; in caso contrario, l'applicazione deve prepararsi senza l'interazione dell'utente. Tutti gli altri valori di bit sono riservati.

Valore restituito

Restituisce TRUE per concedere la richiesta di sospensione. Per negare la richiesta, restituire BROADCAST_QUERY_DENY.

Osservazioni:

Un'applicazione deve elaborare questo evento il più rapidamente possibile. L'applicazione può richiedere istruzioni su come prepararsi per la sospensione solo se è impostato il bit 0 nel parametro Flags . Tuttavia, se questo messaggio viene emesso perché l'utente sta chiudendo il coperchio del portatile, non sarà possibile richiedere all'utente. Le applicazioni devono rispettare che l'utente si aspetta un determinato comportamento quando chiude il coperchio del portatile o preme il pulsante di alimentazione e consente la transizione per avere esito positivo.

Il sistema consente circa 20 secondi per un'applicazione di rimuovere il messaggio WM_POWERBROADCAST che invia l'evento PBT_APMQUERYSUSPEND dalla coda di messaggi dell'applicazione. Se un'applicazione non rimuove il messaggio dalla coda in meno di 20 secondi, il sistema presuppone che l'applicazione sia in uno stato non reattivo e che l'applicazione accetti la richiesta di sospensione. Le applicazioni che non elaborano le code di messaggi potrebbero aver interrotto le operazioni. Dopo aver rimosso il messaggio dalla coda dei messaggi, un'applicazione può richiedere il tempo necessario per eseguire le operazioni necessarie prima di entrare nello stato di sospensione. Tutte le operazioni che potrebbero richiedere più di 20 secondi devono essere eseguite in questo momento, poiché il sistema consente solo 20 secondi per il completamento delle operazioni durante l'elaborazione PBT_APMSUSPEND .

Requisiti

Vedi anche

• Eventi di riattivazione del sistema
• Eventi di risparmio energia
• PBT_APMSUSPEND
• WM_POWERBROADCAST