WINBIO_EVENT構造体
WINBIO_EVENT構造体には、イベント通知が発生したときにコールバック ルーチンに送信される状態情報が含まれます。
構文
typedef struct _WINBIO_EVENT {
WINBIO_EVENT_TYPE Type;
union {
struct {
WINBIO_UNIT_ID UnitId;
WINBIO_REJECT_DETAIL RejectDetail;
} Unclaimed;
struct {
WINBIO_UNIT_ID UnitId;
WINBIO_IDENTITY Identity;
WINBIO_BIOMETRIC_SUBTYPE SubFactor;
WINBIO_REJECT_DETAIL RejectDetail;
} UnclaimedIdentify;
struct {
HRESULT ErrorCode;
} Error;
} Parameters;
} WINBIO_EVENT, *PWINBIO_EVENT;
メンバー
-
Type
-
発生したサービス プロバイダー イベント通知の種類を示す 値。 現在サポートされているプロバイダーは指紋センサーのみです。 このセンサーは、次のフラグをサポートしています。
-
WINBIO_EVENT_FP_UNCLAIMED (センサーは、アプリケーションまたは現在フォーカスがあるウィンドウによって要求されていない指のスワイプを検出しました。Windows 生体認証フレームワークはコールバック関数を呼び出して、指のスワイプが発生したが指紋の識別を試みないことを示します)。
-
WINBIO_EVENT_FP_UNCLAIMED_IDENTIFY (センサーは、アプリケーションまたは現在フォーカスがあるウィンドウによって要求されていない指のスワイプを検出しました。Windows 生体認証フレームワークは指紋の識別を試み、そのプロセスの結果をコールバック関数に渡します)。
-
-
パラメーター
-
-
未請求
-
生体認証サンプル キャプチャ用に返される構造。
-
UnitId
-
サンプルを生成した生体認証ユニット。
-
RejectDetail
-
生体認証サンプルのキャプチャ失敗に関する追加情報を含む ULONG 値。 キャプチャが成功した場合、このパラメーターは 0 に設定されます。 指紋キャプチャには、次の値が定義されています。
- WINBIO_FP_TOO_HIGH
- WINBIO_FP_TOO_LOW
- WINBIO_FP_TOO_LEFT
- WINBIO_FP_TOO_RIGHT
- WINBIO_FP_TOO_FAST
- WINBIO_FP_TOO_SLOW
- WINBIO_FP_POOR_QUALITY
- WINBIO_FP_TOO_SKEWED
- WINBIO_FP_TOO_SHORT
- WINBIO_FP_MERGE_FAILURE
-
-
UnclaimedIdentify
-
生体認証キャプチャと識別のために返される構造。 識別は、サンプルを既存の生体認証テンプレートに関連付けることができるかどうかを決定します。
-
UnitId
-
サンプルを生成した生体認証ユニット。
-
ID
-
生体認証サンプルを提供するユーザーの GUID または SID を含む WINBIO_IDENTITY 構造体。
-
SubFactor
-
生体認証サンプルに関連付けられているサブ要素を指定する WINBIO_BIOMETRIC_SUBTYPE 値。 現在、Windows 生体認証フレームワーク (WBF) は指紋キャプチャのみをサポートしており、次の定数を使用してサブタイプ情報を表します。
- WINBIO_ANSI_381_POS_UNKNOWN
- WINBIO_ANSI_381_POS_RH_THUMB
- WINBIO_ANSI_381_POS_RH_INDEX_FINGER
- WINBIO_ANSI_381_POS_RH_MIDDLE_FINGER
- WINBIO_ANSI_381_POS_RH_RING_FINGER
- WINBIO_ANSI_381_POS_RH_LITTLE_FINGER
- WINBIO_ANSI_381_POS_LH_THUMB
- WINBIO_ANSI_381_POS_LH_INDEX_FINGER
- WINBIO_ANSI_381_POS_LH_MIDDLE_FINGER
- WINBIO_ANSI_381_POS_LH_RING_FINGER
- WINBIO_ANSI_381_POS_LH_LITTLE_FINGER
- WINBIO_ANSI_381_POS_RH_FOUR_FINGERS
- WINBIO_ANSI_381_POS_LH_FOUR_FINGERS
- WINBIO_ANSI_381_POS_TWO_THUMBS
重要
SubFactor 値に指定された値の検証を試みないでください。 Windows 生体認証サービスは、指定された値を実装に渡す前に検証します。 値が WINBIO_SUBTYPE_NO_INFORMATION または WINBIO_SUBTYPE_ANY場合は、必要に応じて検証します。
-
RejectDetail
-
生体認証サンプルのキャプチャ失敗に関する追加情報を含む ULONG 値。 キャプチャが成功した場合、このパラメーターは 0 に設定されます。 指紋キャプチャには、次の値が定義されています。
- WINBIO_FP_TOO_HIGH
- WINBIO_FP_TOO_LOW
- WINBIO_FP_TOO_LEFT
- WINBIO_FP_TOO_RIGHT
- WINBIO_FP_TOO_FAST
- WINBIO_FP_TOO_SLOW
- WINBIO_FP_POOR_QUALITY
- WINBIO_FP_TOO_SKEWED
- WINBIO_FP_TOO_SHORT
- WINBIO_FP_MERGE_FAILURE
-
-
Error
-
監視対象の操作の成功または失敗を識別する構造体。
-
ErrorCode
-
S_OKまたは Windows 生体認証フレームワークによって実行された計算の結果として発生したエラー コードを含む HRESULT 値。
-
-
解説
WinBioRegisterEventMonitor 関数を呼び出して、Windows 生体認証フレームワークからイベント通知を受信するコールバック ルーチンを登録します。 コールバックは、アプリケーション用に定義する必要があるカスタム関数です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2008 R2 [デスクトップ アプリのみ] |
| Header |
|