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 [僅限傳統型應用程式] |
| 標頭 |
|