Fungsi AllowSetForegroundWindow (winuser.h)

Artikel
03/11/2023

Memungkinkan proses yang ditentukan untuk mengatur jendela latar depan menggunakan fungsi SetForegroundWindow . Proses panggilan harus sudah dapat mengatur jendela latar depan. Untuk informasi selengkapnya, lihat Keterangan nanti dalam topik ini.

Sintaks

BOOL AllowSetForegroundWindow(
  [in] DWORD dwProcessId
);

Parameter

[in] dwProcessId

Jenis: DWORD

Pengidentifikasi proses yang akan diaktifkan untuk mengatur jendela latar depan. Jika parameter ini ASFW_ANY, semua proses akan diaktifkan untuk mengatur jendela latar depan.

Nilai kembali

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Fungsi akan gagal jika proses panggilan tidak dapat mengatur jendela latar depan. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Sistem membatasi proses mana yang dapat mengatur jendela latar depan. Biasanya, proses dapat mengatur jendela latar depan dengan memanggil fungsi SetForegroundWindow hanya jika:

Semua kondisi berikut ini benar:
- Proses panggilan milik aplikasi desktop, bukan aplikasi UWP atau aplikasi Windows Store yang dirancang untuk Windows 8 atau 8.1.
- Proses latar depan belum menonaktifkan panggilan ke SetForegroundWindow dengan panggilan sebelumnya ke fungsi LockSetForegroundWindow .
- Batas waktu kunci latar depan telah kedaluwarsa (lihat SPI_GETFOREGROUNDLOCKTIMEOUT di SystemParametersInfo).
- Tidak ada menu yang aktif.
Selain itu, setidaknya salah satu kondisi berikut ini benar:
- Proses panggilan adalah proses latar depan.
- Proses panggilan dimulai oleh proses latar depan.
- Saat ini tidak ada jendela latar depan, dan dengan demikian tidak ada proses latar depan.
- Proses panggilan menerima peristiwa input terakhir.
- Baik proses latar depan atau proses panggilan sedang di-debug.

Proses yang dapat mengatur jendela latar depan dapat mengaktifkan proses lain untuk mengatur jendela latar depan dengan memanggil AllowSetForegroundWindow. Proses yang ditentukan oleh parameter dwProcessId kehilangan kemampuan untuk mengatur jendela latar depan lain kali pengguna menghasilkan input, kecuali input diarahkan pada proses tersebut, atau kali berikutnya proses memanggil AllowSetForegroundWindow, kecuali proses yang sama ditentukan seperti dalam panggilan sebelumnya ke AllowSetForegroundWindow.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-window-l1-1-0 (diperkenalkan dalam Windows 8)