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 位值，其中高四位指定主数字，低 4 位指定次要版本号。 目前必须WINBIO_CBEFF_HEADER_VERSION (0x11) 。
-
PatronHeaderVersion
-
指定标头版本的 WINBIO_BIR_VERSION 常量。 版本号是 8 位值，其中高四位指定主数字，低 4 位指定次要版本号。 目前必须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值，该值指定与生物识别数据关联的子因子。 有关详细信息，请参阅备注和 WINBIO_BIOMETRIC_SUBTYPE常量。
-
用途
-
一个WINBIO_BIR_PURPOSE掩码，用于指定数据的预期用途。 这可以是以下值的按位 或 。 有关详细信息，请参阅 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
-
创建 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 中生成标准数据块的组件的产品 ID。 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 [仅限桌面应用] |
| 标头 |
|