Поделиться через

Функция WinBioReleaseFocus (winbio.h)

  • Статья

Фокус окна выпуска.

Синтаксис

HRESULT WinBioReleaseFocus();

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

Если функция завершается успешно, она возвращает S_OK. Если функция завершается сбоем, она возвращает значение HRESULT , указывающее на ошибку. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Код возврата Описание
E_ACCESSDENIED
 Вызывающий процесс должен выполняться под учетной записью Локальной системы.

Комментарии

Windows Biometric Framework использует фокус окна для арбитража между несколькими сеансами, подключенными к системным пулам.

Способ получения фокуса зависит от типа приложения, которое вы пишете. Например, при создании приложения с графическим интерфейсом можно реализовать обработчик сообщений, который захватывает WM_ACTIVATE, WM_SETFOCUS или другое соответствующее сообщение. Если вы пишете приложение CUI, вызовите Метод GetConsoleWindow , чтобы получить дескриптор в окно консоли, и передать этот дескриптор в функцию SetForegroundWindow , чтобы принудительно перейти в окно консоли на передний план и назначить ему фокус. Если приложение выполняется в отключенном процессе или является службой Windows и не имеет окна, используйте WinBioAcquireFocus и WinBioReleaseFocus для управления фокусом вручную.

В следующем списке перечислены основные моменты, которые следует учитывать перед вызовом WinBioAcquireFocus и WinBioReleaseFocus.

  • Вызывающий процесс должен выполняться под учетной записью Локальной системы.
  • Процесс, который напрямую отображает пользовательский интерфейс, не должен вызывать WinBioAcquireFocus. Ознакомьтесь с предыдущим обсуждением, чтобы определить, как сосредоточиться на приложениях графического пользовательского интерфейса и CUI.
  • Только служба или отсоединяемый процесс, который не отображает пользовательский интерфейс напрямую во время вызовов биометрических API, должен вызывать эту функцию.
Если вы не получите фокус при вызове следующих функций, они будут работать непредвиденным образом:

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header winbio.h (включая Winbio.h)
Библиотека Winbio.lib
DLL Winbio.dll

См. также раздел

Функции клиентских приложений

WinBioEnrollBegin