Функция AllowSetForegroundWindow (winuser.h)

Позволяет указанному процессу задать окно переднего плана с помощью функции SetForegroundWindow . Вызывающий процесс должен уже иметь возможность задать окно переднего плана. Дополнительные сведения см. в разделе "Примечания" далее в этом разделе.

Синтаксис

BOOL AllowSetForegroundWindow(
  [in] DWORD dwProcessId
);

Параметры

[in] dwProcessId

Тип: DWORD

Идентификатор процесса, который будет включен для задания окна переднего плана. Если этот параметр ASFW_ANY, все процессы будут включены для задания окна переднего плана.

Возвращаемое значение

Тип: BOOL

Если функция выполнена успешно, возвращаемое значение ненулевое.

Если функция завершается ошибкой, возвращаемое значение равно нулю. Функция завершится ошибкой, если вызывающий процесс не может задать окно переднего плана. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Система ограничивает, какие процессы могут задать окно переднего плана. Как правило, процесс может задать окно переднего плана, вызвав функцию SetForegroundWindow , только если:

• Все следующие условия имеют значение true:
  • Вызывающий процесс принадлежит классическому приложению, а не приложению UWP или приложению Магазина Windows, предназначенному для Windows 8 или 8.1.
  • Процесс переднего плана не отключил вызовы SetForegroundWindow предыдущим вызовом функции LockSetForegroundWindow .
  • Меню не активны.
• Кроме того, по крайней мере одно из следующих условий имеет значение true:
  • Истек срок ожидания блокировки переднего плана (см. SPI_GETFOREGROUNDLOCKTIMEOUT в SystemParametersInfo).
  • Вызывающий процесс — это процесс переднего плана.
  • Вызывающий процесс был запущен процессом переднего плана.
  • В настоящее время нет окна переднего плана и, следовательно, нет процесса переднего плана.
  • Вызывающий процесс получил последнее событие ввода.
  • Выполняется отладка процесса переднего плана или вызывающего процесса.

Процесс, который может задать окно переднего плана, может включить другой процесс для задания окна переднего плана путем вызова AllowSetForegroundWindow. Процесс, указанный параметром dwProcessId , теряет возможность задать окно переднего плана в следующий раз, когда пользователь создает входные данные, если входные данные не направлены на этот процесс, или при следующем вызове процесса AllowSetForegroundWindow, если только не указан тот же процесс, как в предыдущем вызове AllowSetForegroundWindow.

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Library	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-window-l1-1-0 (представлено в Windows 8)

См. также

Концептуальный

LockSetForegroundWindow

Справочные материалы

SetForegroundWindow

Виндоус