WINBIO_BIR_HEADER-Struktur
Die WINBIO_BIR_HEADER-Struktur enthält den Header eines biometrischen Informationseintrags (BIR).
Syntax
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;
Member
-
ValidFields
-
Bitmaske, die angibt, welche Felder in dieser Struktur gültig sind. Weitere Informationen finden Sie unter WINBIO_BIR_FIELD Konstanten.
-
Header Version
-
Eine WINBIO_BIR_VERSION Konstante, die die Headerversion angibt. Versionsnummern sind 8-Bit-Werte, bei denen die oberen vier Bits die Hauptnummer und die niedrigen vier Bits die Nebenversionsnummer angeben. Dies muss derzeit WINBIO_CBEFF_HEADER_VERSION (0x11) sein.
-
PatronHeaderVersion
-
Eine WINBIO_BIR_VERSION Konstante, die die Headerversion angibt. Versionsnummern sind 8-Bit-Werte, bei denen die oberen vier Bits die Hauptnummer und die niedrigen vier Bits die Nebenversionsnummer angeben. Derzeit muss dies WINBIO_PATRON_HEADER_VERSION (0x11) sein.
-
DataFlags
-
Ein -Wert, der das Format der Headerdaten angibt. Dies kann ein bitweises OR der folgenden Flags auf Sicherheits- und Verarbeitungsebene sein. Weitere Informationen finden Sie unter WINBIO_BIR_DATA_FLAGS Konstanten.
Wert Bedeutung - WINBIO_DATA_FLAG_PRIVACY
- ((UCHAR)0x02)
Die Daten sind verschlüsselt. - WINBIO_DATA_FLAG_INTEGRITY
- ((UCHAR)0x01)
Die Daten werden digital signiert oder durch einen Nachrichtenauthentifizierungscode (MAC) geschützt. - WINBIO_DATA_FLAG_SIGNED
- ((UCHAR)0x04)
Wenn dieses Flag und das WINBIO_DATA_FLAG_INTEGRITY-Flag festgelegt sind, werden die Daten signiert. Wenn dieses Flag nicht festgelegt ist, aber das WINBIO_DATA_FLAG_INTEGRITY-Flag festgelegt ist, wird ein MAC über die Daten berechnet. - WINBIO_DATA_FLAG_RAW
- ((UCHAR)0x20)
Die Daten haben das Format, mit dem sie erfasst wurden. - WINBIO_DATA_FLAG_INTERMEDIATE
- ((UCHAR)0x40)
Die Daten sind nicht roh, wurden aber noch nicht vollständig verarbeitet. - WINBIO_DATA_FLAG_PROCESSED
- ((UCHAR)0x80)
Die Daten wurden verarbeitet. - WINBIO_DATA_FLAG_OPTION_MASK_PRESENT
- ((UCHAR)0x08)
Dieser Wert ist immer 1. -
Typ
-
Ein WINBIO_BIOMETRIC_TYPE Wert, der den Typ der biometrischen Daten angibt, auf die im biometrischen Informationseintrag verwiesen wird. Derzeit wird nur WINBIO_TYPE_FINGERPRINT unterstützt. Weitere Informationen finden Sie unter WINBIO_BIOMETRIC_TYPE Konstanten.
-
Subtype
-
Ein WINBIO_BIOMETRIC_SUBTYPE Wert, der den den biometrischen Daten zugeordneten Unterfaktor angibt. Weitere Informationen finden Sie unter Hinweise und WINBIO_BIOMETRIC_SUBTYPE Konstanten.
-
Zweck
-
Eine WINBIO_BIR_PURPOSE Maske, die die beabsichtigte Verwendung der Daten angibt. Dies kann ein bitweises OR der folgenden Werte sein. Weitere Informationen finden Sie unter WINBIO_BIR_PURPOSE Konstanten.
- WINBIO_PURPOSE_VERIFY
- WINBIO_PURPOSE_IDENTIFY
- WINBIO_PURPOSE_ENROLL
- WINBIO_PURPOSE_ENROLL_FOR_VERIFICATION
- WINBIO_PURPOSE_ENROLL_FOR_IDENTIFICATION
- WINBIO_PURPOSE_AUDIT
-
DataQuality
-
Ein -Wert, der die relative Qualität der biometrischen Daten im biometrischen Informationsdatensatz (BIR) angibt. Dies kann eine ganze Zahl von 0 bis 100 oder einer der folgenden Werte sein. Weitere Informationen finden Sie unter WINBIO_BIR_QUALITY Konstanten.
Wert Bedeutung - WINBIO_DATA_QUALITY_NOT_SET
- ((WINBIO_BIR_QUALITY)-1)
Qualitätsmessungen werden vom BIR-Ersteller unterstützt, aber im BIR wird kein Wert festgelegt. - WINBIO_DATA_QUALITY_NOT_SUPPORTED
- ((WINBIO_BIR_QUALITY)-2)
Qualitätsmessungen werden vom BIR-Ersteller nicht unterstützt. -
CreationDate
-
Das Datum und die Uhrzeit in koordinierter Weltzeit (Greenwich Mean Time), die die BIR erstellt wurde.
-
ValidityPeriod
-
Der Zeitraum, für den die BIR gültig ist.
-
BeginDate
-
Das Datum und die Uhrzeit in koordinierter Weltzeit, zu dem der Gültigkeitszeitraum beginnt.
-
EndDate
-
Das Datum und die Uhrzeit in koordinierter Weltzeit, an dem die BIR nicht mehr gültig ist.
-
-
BiometricDataFormat
-
Eine WINBIO_REGISTERED_FORMAT-Struktur , die das Datenformat des Standarddatenblocks in der WINBIO_BIR-Struktur angibt. Die WINBIO_REGISTERED_FORMAT Member dürfen nicht 0 (null) sein. Sie können die folgenden Konstanten verwenden, um die Fehlerüberprüfung zu vereinfachen.
Wert Bedeutung - WINBIO_NO_FORMAT_OWNER_AVAILABLE
- ((USHORT)0)
Es wurde kein IBIA (International Biometric Industry Association) zugewiesener Besitzerwert angegeben. - WINBIO_NO_FORMAT_TYPE_AVAILABLE
- ((USHORT)0)
Es wurde kein Formattyp angegeben. -
ProductId
-
Eine WINBIO_REGISTERED_FORMAT-Struktur , die die Produkt-ID der Komponente angibt, die den Standarddatenblock in der BIR generiert hat. Die WINBIO_REGISTERED_FORMAT Member können 0 (null) sein.
Bemerkungen
Der Parameter Subtype gibt den Teilfaktor an, der den biometrischen Daten zugeordnet ist. Derzeit unterstützt das Windows Biometric Framework (WBF) nur die Fingerabdruckerfassung und verwendet die folgenden Konstanten, um Untertypinformationen darzustellen:
- 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
Wichtig
Versuchen Sie nicht, den für den Subtype-Parameterwert angegebenen Wert zu überprüfen. Der Windows-Biometrische Dienst überprüft den angegebenen Wert, bevor er an Ihre Implementierung übergeben wird. Wenn der Wert WINBIO_SUBTYPE_NO_INFORMATION oder WINBIO_SUBTYPE_ANY ist, überprüfen Sie gegebenenfalls.
Wenn eines der folgenden Bits behauptet wird, wird die WINBIO_BIR_HEADER Struktur nicht ordnungsgemäß gebildet.
#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 )
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 R2 [nur Desktop-Apps] |
| Header |
|