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;
成員
-
類型
-
值，指定引發的服務提供者事件通知類型。 目前唯一支援的提供者是指紋感應器。 此感應器支援下列旗標。
-
WINBIO_EVENT_FP_UNCLAIMED (感應器偵測到應用程式或目前具有焦點的視窗未要求的手指撥動。Windows 生物特徵辨識架構會呼叫回呼函式，指出已發生手指撥動，但不會嘗試識別指紋。)
-
WINBIO_EVENT_FP_UNCLAIMED_IDENTIFY (感應器偵測到應用程式或目前有焦點的視窗未要求的手指撥動。Windows 生物特徵辨識架構會嘗試識別指紋，並將該程式的結果傳遞至回呼函式。)
-
-
參數
-
-
無人 認領
-
傳回用於生物特徵辨識範例擷取的結構。
-
UnitId
-
產生樣本的生物特徵辨識單位。
-
RejectDetail
-
ULONG值，其中包含擷取生物特徵辨識樣本失敗的其他資訊。 如果擷取成功，此參數會設定為零。 以下是針對指紋擷取定義的值：
- 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
-
產生樣本的生物特徵辨識單位。
-
身分識別
-
包含使用者提供生物特徵辨識範例之 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值，其中包含擷取生物特徵辨識樣本失敗的其他資訊。 如果擷取成功，此參數會設定為零。 以下是針對指紋擷取定義的值：
- 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
-
-
錯誤
-
結構，識別受監視之作業的成功或失敗。
-
ErrorCode
-
HRESULT 值，其中包含S_OK或 Windows 生物特徵辨識架構所執行計算所產生的錯誤碼。
-
-
備註
呼叫 WinBioRegisterEventMonitor 函式來註冊回呼常式，以接收來自 Windows 生物特徵辨識架構的事件通知。 回呼是您必須為應用程式定義的自訂函式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2008 R2 [僅限桌面應用程式] |
| 標頭 |
|