Funzione PowerClearRequest (winbase.h)

Decrementa il numero di richieste di alimentazione del tipo specificato per un oggetto power request.

Sintassi

BOOL PowerClearRequest(
  [in] HANDLE             PowerRequest,
  [in] POWER_REQUEST_TYPE RequestType
);

Parametri

[in] PowerRequest

Handle per un oggetto power request.

[in] RequestType

Tipo di richiesta di alimentazione da decrementare. Questo parametro può avere uno dei valori seguenti.

Valore Significato
PowerRequestDisplayRequired
La visualizzazione rimane attiva anche se non è presente alcun input utente per un periodo di tempo esteso.
PowerRequestSystemRequired
Il sistema continua a essere eseguito invece di entrare in sospensione dopo un periodo di inattività dell'utente.
PowerRequestAwayModeRequired
Il sistema entra in modalità di distanza invece di dormire. In modalità di distanza, il sistema continua a funzionare, ma disattiva l'audio e il video per dare l'aspetto del sonno.
PowerRequestExecutionRequired
Il processo chiamante continua a essere eseguito anziché essere sospeso o terminato dai meccanismi di gestione della durata del processo. Quando e la durata dell'esecuzione del processo dipende dalle impostazioni del sistema operativo e dei criteri di alimentazione.

Quando una richiesta PowerRequestExecutionRequired è attiva, implica PowerRequestSystemRequired.

Il tipo di richiesta PowerRequestExecutionRequired può essere usato solo dalle applicazioni. I servizi non possono usare questo tipo di richiesta.

Windows 7 e Windows Server 2008 R2: Questo tipo di richiesta è supportato a partire da Windows 8 e Windows Server 2012.

Valore restituito

Se la funzione ha esito positivo, restituisce un valore diverso da zero.

Se la funzione ha esito negativo, restituisce zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winbase.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

PowerCreateRequest

PowerSetRequest