WinBioMonitorPresence 関数 (winbio.h)

  • [アーティクル]

指定した生体認証ユニットの顔認識または虹彩監視メカニズムをオンにします。 ビルド 1607 Windows 10以降、この関数はモバイル イメージで使用できます。

構文

HRESULT WinBioMonitorPresence(
  [in] WINBIO_SESSION_HANDLE SessionHandle,
  [in] WINBIO_UNIT_ID        UnitId
);

パラメーター

[in] SessionHandle

PoolType パラメーターを WINBIO_POOL_SYSTEM に設定して WinBioAsyncOpenSession 関数を呼び出して取得した生体認証セッションの非同期ハンドル。

[in] UnitId

顔認識または虹彩監視メカニズムを有効にする生体認証ユニットの識別子。

戻り値

関数パラメーターが許容される場合は、 S_OKを返します。 関数パラメーターが受け入れられない場合は、エラーを示す HRESULT 値を返します。
有効な値を次の表に示しますが、これ以外にもあります。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。

リターン コード 説明
E_HANDLE
 セッション ハンドルが無効です。
E_INVALIDARG
 UnitId パラメーターを 0 にすることはできません。
WINBIO_E_INCORRECT_SESSION_TYPE
 セッション ハンドルは、非同期生体認証セッションに対応していません。
 

操作自体の実際の成功または失敗は、 WINBIO_ASYNC_RESULT 構造の通知関数に返されます。

解説

1 つの生体認証セッションでは、任意の時点でアクティブなプレゼンス モニターを 1 つだけ持つことができます。

WinBioMonitorPresence を正常に呼び出すと、通知関数は Operation メンバーが WINBIO_OPERATION_MONITOR_PRESENCE と等しいWINBIO_ASYNC_RESULT構造体の形式で通知を受け取ります。 その後、WINBIO_ASYNC_RESULT構造体の Parameters.MonitorPresence メンバーを調べて詳細を確認する必要があります。

通知の受信を停止するには、元の非同期ハンドル値を使用して WinBioCancel または WinBioCloseSession を呼び出します。

要件

   
サポートされている最小のクライアント Windows 10 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2016 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winbio.h
Library Winbio.lib
[DLL] Winbio.dll

関連項目

WINBIO_ASYNC_RESULT

WinBioAsyncOpenSession

WinBioCancel

WinBioCloseSession