Share via

WINBIO_BIR_HEADER 結構

  • 發行項

WINBIO_BIR_HEADER結構包含 BIR) (生物特徵辨識資訊記錄的標頭。

語法

typedef struct _WINBIO_BIR_HEADER {
  USHORT                   ValidFields;
  WINBIO_BIR_VERSION       HeaderVersion;
  WINBIO_BIR_VERSION       PatronHeaderVersion;
  WINBIO_BIR_DATA_FLAGS    DataFlags;
  WINBIO_BIOMETRIC_TYPE    Type;
  WINBIO_BIOMETRIC_SUBTYPE Subtype;
  WINBIO_BIR_PURPOSE       Purpose;
  WINBIO_BIR_QUALITY       DataQuality;
  LARGE_INTEGER            CreationDate;
  struct {
    LARGE_INTEGER BeginDate;
    LARGE_INTEGER EndDate;
  } ValidityPeriod;
  WINBIO_REGISTERED_FORMAT BiometricDataFormat;
  WINBIO_REGISTERED_FORMAT ProductId;
} WINBIO_BIR_HEADER;

成員

ValidFields

位元遮罩，指定這個結構中的哪些欄位有效。 如需詳細資訊，請參閱 WINBIO_BIR_FIELD常數。

HeaderVersion

指定標頭版本的 WINBIO_BIR_VERSION 常數。 版本號碼是 8 位值，其中前四位指定主要數位，而低四位則指定次要版本號碼。 目前這必須WINBIO_CBEFF_HEADER_VERSION (0x11) 。

PatronHeaderVersion

指定標頭版本的 WINBIO_BIR_VERSION 常數。 版本號碼是 8 位值，其中前四位指定主要數位，而低四位則指定次要版本號碼。 目前這必須WINBIO_PATRON_HEADER_VERSION (0x11) 。

DataFlags

值，指定標頭資料的格式。 這可以是下列安全性和處理層級旗標的位 OR 。 如需詳細資訊，請參閱 WINBIO_BIR_DATA_FLAGS常數。

值 意義
WINBIO_DATA_FLAG_PRIVACY
( (UCHAR) 0x02)
資料會經過加密。
WINBIO_DATA_FLAG_INTEGRITY
( (UCHAR) 0x01)
資料會以數位方式簽署或受到訊息驗證代碼保護， (MAC) 。
WINBIO_DATA_FLAG_SIGNED
( (UCHAR) 0x04)
如果已設定此旗標和 WINBIO_DATA_FLAG_INTEGRITY 旗標，則會簽署資料。 如果未設定此旗標，但已設定 WINBIO_DATA_FLAG_INTEGRITY 旗標，則會透過資料計算 MAC。
WINBIO_DATA_FLAG_RAW
( (UCHAR) 0x20)
資料的格式為擷取資料。
WINBIO_DATA_FLAG_INTERMEDIATE
( (UCHAR) 0x40)
資料不是未經處理，但尚未完全處理。
WINBIO_DATA_FLAG_PROCESSED
( (UCHAR) 0x80)
資料已處理。
WINBIO_DATA_FLAG_OPTION_MASK_PRESENT
( (UCHAR) 0x08)
這個值一律是 1。

類型

WINBIO_BIOMETRIC_TYPE值，指定生物特徵辨識資訊記錄中所參考生物特徵辨識資料的類型。 目前僅支援 WINBIO_TYPE_FINGERPRINT 。 如需詳細資訊，請參閱 WINBIO_BIOMETRIC_TYPE常數。

子類型

WINBIO_BIOMETRIC_SUBTYPE值，指定與生物特徵辨識資料相關聯的子因素。 For more information, see Remarks and WINBIO_BIOMETRIC_SUBTYPE Constants.

目的

指定資料的預定用途的 WINBIO_BIR_PURPOSE 遮罩。 這可以是下列值的位 OR 。 如需詳細資訊，請參閱 WINBIO_BIR_PURPOSE常數。

  • WINBIO_PURPOSE_VERIFY
  • WINBIO_PURPOSE_IDENTIFY
  • WINBIO_PURPOSE_ENROLL
  • WINBIO_PURPOSE_ENROLL_FOR_VERIFICATION
  • WINBIO_PURPOSE_ENROLL_FOR_IDENTIFICATION
  • WINBIO_PURPOSE_AUDIT

DataQuality

值，指定 BIR) (生物特徵辨識資訊記錄中生物特徵辨識資料的相對品質。 這可以是介於 0 到 100 或下列其中一個值的整數。 如需詳細資訊，請參閱 WINBIO_BIR_QUALITY常數。

值 意義
WINBIO_DATA_QUALITY_NOT_SET
( (WINBIO_BIR_QUALITY) -1)
BIR 建立者支援品質度量，但 BIR 中未設定任何值。
WINBIO_DATA_QUALITY_NOT_SUPPORTED
( (WINBIO_BIR_QUALITY) -2)
BIR 建立者不支援品質度量。

CreationDate

以國際標準時間 (Greenwich Mean Time) 建立 BIR 的日期和時間。

ValidityPeriod

BIR 有效期間的期間。

BeginDate

有效期間開始的日期和時間，以國際標準時程表示。

EndDate

以國際標準時程表示的日期和時間，BIR 停止有效。

BiometricDataFormat

WINBIO_REGISTERED_FORMAT結構，指定WINBIO_BIR結構中標準資料區塊的資料格式。 WINBIO_REGISTERED_FORMAT成員不可為零。 您可以使用下列常數來簡化錯誤檢查。

值 意義
WINBIO_NO_FORMAT_OWNER_AVAILABLE
( (USHORT) 0)
未指定任何 IBIA (國際生物特徵辨識產業協會) 指派的擁有者值。
WINBIO_NO_FORMAT_TYPE_AVAILABLE
( (USHORT) 0)
未指定格式類型。

ProductId

WINBIO_REGISTERED_FORMAT結構，指定產生 BIR 中標準資料區塊之元件的產品識別碼。 WINBIO_REGISTERED_FORMAT成員可以是零。

備註

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

重要

請勿嘗試驗證 針對 Subtype 參數值所提供的值。 Windows 生物特徵辨識服務會先驗證所提供的值，再將它傳遞至您的實作。 如果此值 WINBIO_SUBTYPE_NO_INFORMATION 或 WINBIO_SUBTYPE_ANY，請視需要驗證。

如果判斷提示下列任一位， 則WINBIO_BIR_HEADER 結構的格式不正確。

#define WINBIO_BIR_FIELD_NEVER_VALID    (WINBIO_BIR_FIELD_SUBHEAD_COUNT |   \
                                         WINBIO_BIR_FIELD_PATRON_ID |       \
                                         WINBIO_BIR_FIELD_INDEX |           \
                                         WINBIO_BIR_FIELD_CHALLENGE |       \
                                         WINBIO_BIR_FIELD_PAYLOAD )

規格需求

需求 值
最低支援的用戶端
 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2008 R2 [僅限傳統型應用程式]
標頭
Winbio_types.h (包括 Winbio.h)

另請參閱

用戶端應用程式結構

WINBIO_BIOMETRIC_SUBTYPE常數

WINBIO_BIR

WINBIO_BIR_DATA_FLAGS常數

WINBIO_BIR_FIELD常數

WINBIO_BIR_PURPOSE常數

WINBIO_BIR_QUALITY常數

WINBIO_BIR_VERSION常數