структура 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
-
Значение типа , указывающее формат данных заголовка. Это может быть побитовое ИЛИ следующих флагов уровня безопасности и обработки. Дополнительные сведения см. в разделе константы 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.
-
Subtype
-
Значение 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
-
Дата и время в универсальном координированном времени, когда БИР перестает быть действительным.
-
-
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 [только классические приложения] |
| Заголовок |
|