winBioAcquireFocus 函数 (winbio.h)

获取窗口焦点。

语法

HRESULT WinBioAcquireFocus();

返回值

如果函数成功，则返回 S_OK。 如果函数失败，它将返回指示错误的 HRESULT 值。 可能的值包括（但并不限于）下表中的项。 有关常见错误代码的列表，请参阅 常见 HRESULT 值。

返回代码	说明
E_ACCESSDENIED	调用进程必须在本地系统帐户下运行。

注解

Windows 生物识别框架使用窗口焦点在连接到系统池的多个会话之间进行仲裁。

获取焦点的方式取决于正在编写的应用程序类型。 例如，如果要创建 GUI 应用程序，则可以实现捕获 WM_ACTIVATE、 WM_SETFOCUS或其他相应消息的消息处理程序。 如果要编写 CUI 应用程序，请调用 GetConsoleWindow 检索控制台窗口的句柄，并将该句柄传递给 SetForegroundWindow 函数，以强制控制台窗口进入前台并为其分配焦点。 如果应用程序在分离进程中运行，或者是 Windows 服务，并且没有窗口，请使用 WinBioAcquireFocus 和 WinBioReleaseFocus 手动控制焦点。

以下列表汇总了调用此函数之前要考虑的要点。

• 调用进程必须在本地系统帐户下运行。
• 直接显示用户界面的进程不应调用此函数。 请参阅前面的讨论，确定如何获取 GUI 和 CUI 应用程序的焦点。
• 只有未在生物识别 API 调用期间直接显示用户界面的服务或分离进程应调用此函数。
• 如果函数成功，则必须调用 WinBioReleaseFocus 以释放焦点。

如果在调用以下函数时未获得焦点，它们的行为方式会出人意料：

• WinBioEnrollBegin
• WinBioEnrollCapture
• WinBioEnrollCaptureWithCallback

要求

要求	值
最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
目标平台	Windows
标头	winbio.h (包括 Winbio.h)
Library	Winbio.lib
DLL	Winbio.dll

另请参阅

客户端应用程序函数

WinBioEnrollBegin