Функция AllowSetForegroundWindow включает заданный процесс, чтобы установить приоритетное окно, используя функцию SetForegroundWindow. Вызывающий процесс должен уже получить возможность установить приоритетное окно. Для получения дополнительной информации, см. Замечания ниже в этой теме.

BOOL AllowSetForegroundWindow(

          DWORD dwProcessId

[in] Определяет идентификатор процесса, который должен быть включенным, чтобы установить приоритетное окно. Если этот параметр является ASFW_ANY, все процессы, должен быть включенными, чтобы установить приоритетное окно.

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

• Процесс является приоритетным процессом.
• Процесс был запущен приоритетным процессом.
• Процесс получил последнее событие ввода данных.
• Нет ни одного приоритетного процесса.
• Приоритетный процесс в режиме отладки.
• Активный режим не блокирован (см. статью LockSetForegroundWindow).
• Время блокировки приоритетного режима истекло (см. описание флажка SPI_GETFOREGROUNDLOCKTIMEOUT в функции SystemParametersInfo).
• Windows 2000/XP: Нет активного меню.

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

Эта функция не реализуется. Поэтому, процессы должны сотрудничать, чтобы управлять приоритетным окном. Например, приложение может захотеть поддержать только один экземпляр программы. Когда запускается второй экземпляр, оно должно обнаружить предыдущий экземпляр и вызывать функцию SetForegroundWindow для окна предыдущего экземпляра. Оно не должно посылать сообщение к окну предыдущего экземпляра, запросившего приложение вызвать для себя функцию SetForegroundWindow, потому что предыдущий экземпляр не обязательно будет иметь разрешение вызвать SetForegroundWindow.

Краткий обзор Окна, LockSetForegroundWindow, SetForegroundWindow