AllowSetForegroundWindow 函式 （winuser.h）

讓指定的程式能夠使用 SetForegroundWindow 函式來設定前景視窗。 呼叫程式必須已經能夠設定前景視窗。 如需詳細資訊，請參閱本主題稍後的備註。

語法

BOOL AllowSetForegroundWindow(
  [in] DWORD dwProcessId
);

參數

[in] dwProcessId

類型：DWORD

將啟用以設定前景視窗的進程識別碼。 如果此參數 ASFW_ANY，則會啟用所有進程來設定前景視窗。

返回值

類型： 布爾值

如果函式成功，則傳回值為非零值。

如果函式失敗，傳回值為零。 如果呼叫進程無法設定前景視窗，函式將會失敗。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

系統會限制哪些進程可以設定前景視窗。 一般而言，只有在下列情況下，進程才能呼叫 SetForegroundWindow 函式來設定前景視窗：

• 下列所有條件都成立：
  • 呼叫程式屬於傳統型應用程式，而不是針對 Windows 8 或 8.1 設計的 UWP 應用程式或 Windows 市集應用程式。
  • 前景進程尚未停用先前呼叫 LockSetForegroundWindow 函式對 SetForegroundWindow 的呼叫。
  • 沒有作用中的選單。
• 此外，至少符合下列其中一個條件：
  • 前景鎖定逾時已過期 （請參閱 SystemParametersInfo） 中的SPI_GETFOREGROUNDLOCKTIMEOUT。
  • 呼叫進程是前景進程。
  • 呼叫程序是由前景程序啟動的。
  • 目前沒有前景視窗，因此沒有前景進程。
  • 呼叫處理程序收到最後一個輸入事件。
  • 正在偵錯前景進程或呼叫進程。

可設定前景視窗的進程可以呼叫 AllowSetForegroundWindow，讓另一個進程設定前景視窗。 dwProcessId 參數所指定的進程會失去下次使用者產生輸入時設定前景視窗的能力，除非輸入指向該進程，或下次進程呼叫 AllowSetForegroundWindow 時，除非指定的進程與上一個呼叫 AllowSetForegroundWindow 相同的進程。

需求

另請參閱

概念

鎖定設定前景視窗

參考

設定前景視窗

Windows 作業系統