Share via

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 [僅限桌面應用程式]
標頭
Winbio_types.h (包含 Winbio.h)

另請參閱

用戶端應用程式結構

WinBioRegisterEventMonitor