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 を呼び出してフォーカスを解放する必要があります。

• WinBioEnrollBegin
• WinBioEnrollCapture
• WinBioEnrollCaptureWithCallback

要件

こちらもご覧ください

クライアント アプリケーション関数

WinBioEnrollBegin