Fungsi PowerClearRequest (winbase.h)

Mengurangi jumlah permintaan daya dari jenis yang ditentukan untuk objek permintaan daya.

Sintaks

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

Parameter

[in] PowerRequest

Handel ke objek permintaan daya.

[in] RequestType

Jenis permintaan daya yang akan diderementasi. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
PowerRequestDisplayRequired
Tampilan tetap menyala meskipun tidak ada input pengguna untuk jangka waktu yang lama.
PowerRequestSystemRequired
Sistem terus berjalan alih-alih memasuki tidur setelah periode tidak aktif pengguna.
PowerRequestAwayModeRequired
Sistem memasuki mode menjauh alih-alih tidur. Dalam mode tidak di tempat, sistem terus berjalan tetapi mematikan audio dan video untuk memberikan tampilan tidur.
PowerRequestExecutionRequired
Proses panggilan terus berjalan alih-alih ditangguhkan atau dihentikan oleh mekanisme manajemen seumur hidup proses. Kapan dan berapa lama proses diizinkan untuk berjalan tergantung pada sistem operasi dan pengaturan kebijakan daya.

Ketika permintaan PowerRequestExecutionRequired aktif, itu menyiratkan PowerRequestSystemRequired.

Jenis permintaan PowerRequestExecutionRequired hanya dapat digunakan oleh aplikasi. Layanan tidak dapat menggunakan jenis permintaan ini.

Windows 7 dan Windows Server 2008 R2: Jenis permintaan ini didukung dimulai dengan Windows 8 dan Windows Server 2012.

Nilai kembali

Jika fungsi berhasil, fungsi mengembalikan nilai bukan nol.

Jika fungsi gagal, fungsi akan mengembalikan nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header winbase.h (termasuk Windows.h)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

PowerCreateRequest

PowerSetRequest