次の方法で共有


WinBioEnrollSelect 関数 (winbio.h)

複数の個人を表すデータがサンプル バッファーに存在する場合に登録する個人を指定します。 ビルド 1607 Windows 10以降、この関数はモバイル イメージで使用できます。

構文

HRESULT WinBioEnrollSelect(
  [in] WINBIO_SESSION_HANDLE SessionHandle,
  [in] ULONGLONG             SelectorValue
);

パラメーター

[in] SessionHandle

開いている生体認証セッションを識別する WINBIO_SESSION_HANDLE 値。 WinBioOpenSession を呼び出して、同期セッション ハンドルを開きます。 WinBioAsyncOpenSession を呼び出して非同期セッション ハンドルを開きます。

顔認識に登録するには、PoolType パラメーターを WINBIO_POOL_SYSTEM に設定して WinBioAsyncOpenSession を使用してハンドルを取得します。

[in] SelectorValue

登録に選択する個人を識別する値。

戻り値

関数が成功した場合は、S_OK を返します。 関数が失敗した場合は、エラーを示す HRESULT 値を返します。 有効な値を次の表に示しますが、これ以外にもあります。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。

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

注釈

顔認識に登録する場合は、次の 2 つの方法のいずれかで正しいセレクター値を見つけることができます。

  • 以前に送信したWINBIO_PRESENCE構造体の 1 つの Id メンバーの値。
  • NUI 顔追跡 API によって生成されるデータ。
WinBioEnrollBegin を呼び出して登録シーケンスを開始した後にセレクター値を設定するには、WinBioEnrollSelect を呼び出します。 セレクター値は、後続のすべての WinBioEnrollCapture 呼び出しに適用されます。 選択設定は一時的であり、 WinBioEnrollCommit または WinBioEnrollDiscard を呼び出して登録シーケンスを完了すると自動的にクリアされます。

指紋などのあいまいさを必要としない生体認証要素に 対して WinBioEnrollSelect を呼び出すと、関数の戻り値は成功を示しますが、関数はセレクター値を無視します。

関数を呼び出す必要がある生体認証要素に対して WinBioEnrollSelect を呼び出さない場合、 その後の WinBioEnrollCapture の呼び出しは 、WINBIO_E_SELECTION_REQUIRED エラーで失敗します。

Windows 10、WinBioEnrollSelect を呼び出す必要がある要因は、顔の特徴と虹彩です。

WinBioEnrollSelect は、同期または非同期のセッション ハンドルを使用して呼び出すことができます。 Windows 生体認証フレームワーク API 関数の他の呼び出しと同様に、非同期セッション ハンドルを使用して WinBioEnrollSelect を 呼び出すと、戻り値は関数パラメーターが許容されたことを示すだけです。 操作自体の実際の成功または失敗は、 WINBIO_ASYNC_RESULT 構造体の通知ルーチンに返されます。

要件

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

こちらもご覧ください

WINBIO_ASYNC_RESULT

WINBIO_PRESENCE

WinBioEnrollBegin

WinBioEnrollCapture

WinBioEnrollCommit

WinBioEnrollDiscard