allowSetForegroundWindow 函数 (winuser.h)

使指定的进程能够使用 SetForegroundWindow 函数设置前台窗口。 调用进程必须已经能够设置前台窗口。 有关详细信息,请参阅本主题后面的“备注”。

语法

BOOL AllowSetForegroundWindow(
  [in] DWORD dwProcessId
);

参数

[in] dwProcessId

类型:DWORD

将启用以设置前台窗口的进程标识符。 如果 此参数ASFW_ANY,则将启用所有进程来设置前台窗口。

返回值

类型: BOOL

如果该函数成功,则返回值为非零值。

如果函数失败,则返回值为零。 如果调用进程无法设置前台窗口,该函数将失败。 要获得更多的错误信息,请调用 GetLastError。

注解

系统限制哪些进程可以设置前台窗口。 通常,仅当以下情况时,进程才能通过调用 SetForegroundWindow 函数来设置前台窗口:

  • 以下所有条件都为 true:
  • 此外,至少满足以下条件之一:
    • 调用进程是前台进程。
    • 调用进程由前台进程启动。
    • 当前没有前台窗口,因此没有前台进程。
    • 调用进程收到了最后一个输入事件。
    • 正在调试前台进程或调用进程。

可以设置前台窗口的进程可以通过调用 AllowSetForegroundWindow 使另一个进程能够设置前台窗口。 dwProcessId 参数指定的进程将失去在用户下次生成输入时设置前台窗口的能力,除非输入定向到该进程,或下一次进程调用 AllowSetForegroundWindow 时,除非指定了与上次对 AllowSetForegroundWindow 的调用相同的进程。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 在 Windows 8) 中引入的 ext-ms-win-ntuser-window-l1-1-0 (

请参阅

概念性

LockSetForegroundWindow

引用

SetForegroundWindow

Windows