WinBioAcquireFocus 関数 (winbio.h)
ウィンドウフォーカスを取得します。
構文
HRESULT WinBioAcquireFocus();
戻り値
関数が成功した場合は、S_OK を返します。 関数が失敗した場合は、エラーを示す HRESULT 値を返します。 有効な値を次の表に示しますが、これ以外にもあります。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。
| リターン コード | 説明 |
|---|---|
|
呼び出し元のプロセスは、ローカル システム アカウントで実行されている必要があります。 |
注釈
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 を含む) |
| Library | Winbio.lib |
| [DLL] | Winbio.dll |