通过

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 [仅限桌面应用]
标头
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 常量