共用方式為

winBioAcquireFocus 函式 (winbio.h)

  • 發行項

取得窗口焦點。

Syntax

HRESULT WinBioAcquireFocus();

傳回值

如果函式成功，它會傳回 S_OK。 如果函式失敗，它會傳回 HRESULT 值，指出錯誤。 可能的值包括 (但不限於) 下表中的這些值。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

傳回碼 Description
E_ACCESSDENIED
 呼叫進程必須在本機系統帳戶下執行。

備註

Windows 生物特徵辨識架構會使用視窗焦點，在聯機到系統集區的多個會話之間進行仲裁。

取得焦點的方式取決於您正在撰寫的應用程式類型。 例如，如果您要建立 GUI 應用程式，您可以實作擷取 WM_ACTIVATE、 WM_SETFOCUS或其他適當訊息的訊息處理程式。 如果您要撰寫 CUI 應用程式，請呼叫 GetConsoleWindow 以擷取控制台視窗的句柄，並將該句柄傳遞給 SetForegroundWindow 函式，以強制控制台窗口進入前景並指派焦點。 如果您的應用程式是在中斷鏈接的進程中執行，或是 Windows 服務且沒有視窗，請使用 WinBioAcquireFocus 和 WinBioReleaseFocus 手動控制焦點。

下列清單摘要說明呼叫此函式之前要考慮的主要重點。

  • 呼叫進程必須在本機系統帳戶下執行。
  • 直接顯示使用者介面的程式不應該呼叫此函式。 請參閱上述討論，以判斷如何取得 GUI 和 CUI 應用程式的焦點。
  • 只有未在生物特徵辨識 API 呼叫期間直接顯示使用者介面的服務或中斷鏈接進程，才應該呼叫此函式。
  • 如果函式成功，您必須呼叫 WinBioReleaseFocus 以釋放焦點。
如果您在呼叫下列函式時未取得焦點，它們的行為會以非預期的方式運作：

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 winbio.h (包含Winbio.h)
程式庫 Winbio.lib
Dll Winbio.dll

另請參閱

用戶端應用程式函式

WinBioEnrollBegin