WINBIO _ BIR _ HEADER-Struktur
Die WINBIO _ BIR _ HEADER-Struktur enthält den Header eines biometrischen Informationsdatensatz (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;
Members
-
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 Hauptzahl und die unteren vier Bits die Nebenversionsnummer angeben. Derzeit muss dies WINBIO _ CBEFF _ HEADER _ VERSION (0x11) sein.
-
HeaderVersion
-
Eine WINBIO _ BIR _ VERSION-Konstante, die die Headerversion angibt. Versionsnummern sind 8-Bit-Werte, bei denen die oberen vier Bits die Hauptzahl und die unteren vier Bits die Nebenversionsnummer angeben. Derzeit muss dies WINBIO _ HEADER _ VERSION _ (0x11) sein.
-
DataFlags
-
Ein -Wert, der das Format der Headerdaten angibt. Dies kann ein bitweises OR der folgenden Sicherheits- und Verarbeitungsebenenflags sein. Weitere Informationen finden Sie unter WINBIO _ BIR DATA _ _ FLAGS Constants.
Wert Bedeutung - WINBIO _ DATENSCHUTZ _ FÜR _ DATENFLAGS
- ((UCHAR)0x02)
Die Daten sind verschlüsselt. - WINBIO _ _ _ DATENFLAGINTEGRITÄT
- ((UCHAR)0x01)
Die Daten werden digital signiert oder durch einen Nachrichtenauthentifizierungscode (Message Authentication Code, MAC) geschützt. - WINBIO _ _ _ DATENFLAG SIGNIERT
- ((UCHAR)0x04)
Wenn dieses Flag und das FLAG WINBIO _ DATA FLAG _ _ INTEGRITY festgelegt sind, werden die Daten signiert. Wenn dieses Flag nicht festgelegt ist, aber das FLAG WINBIO _ DATA FLAG _ _ INTEGRITY 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 unformatiert, wurden aber 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 Informationsdatensatz verwiesen wird. Derzeit wird nur WINBIO _ TYPE _ FINGERPRINT unterstützt. Weitere Informationen finden Sie unter WINBIO _ BIOMETRIC TYPE _ Constants.
-
Subtype
-
Ein WINBIO _ BIOMETRIC _ SUBTYPE-Wert, der den unteren Faktor angibt, der den biometrischen Daten zugeordnet ist. Weitere Informationen finden Sie unter Hinweise und WINBIO _ BIOMETRIC _ SUBTYPE Constants.
-
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 _ Constants.
- WINBIO _ PURPOSE _ VERIFY
- WINBIO _ PURPOSE _ IDENTIFY
- WINBIO _ PURPOSE _ ENROLL
- WINBIO _ PURPOSE ENROLL FOR VERIFICATION (WINBIO-ZWECK FÜR ÜBERPRÜFUNG _ _ _ REGISTRIEREN)
- WINBIO _ PURPOSE _ ENROLL _ FOR _ IDENTIFICATION
- _WINBIO-ZWECKÜBERWACHUNG _
-
DataQuality
-
Ein -Wert, der die relative Qualität der biometrischen Daten im biometrischen Informationsdatensatz (BIR) angibt. Dies kann eine ganze Zahl zwischen 0 und 100 oder einer der folgenden Werte sein. Weitere Informationen finden Sie unter WINBIO _ BIR QUALITY _ Constants.
Wert Bedeutung - WINBIO _ DATA _ QUALITY _ NOT _ SET
- ((WINBIO _ BIR _ QUALITY)-1)
Qualitätsmessungen werden vom BIR-Ersteller unterstützt, aber in BIR ist kein Wert festgelegt. - WINBIO _ DATA _ QUALITY _ NOT _ SUPPORTED
- ((WINBIO BIR QUALITY)-2) (NICHT UNTERSTÜTZTE DATENQUALITÄT ((WINBIO _ BIR _ QUALITY)-2))
Qualitätsmessungen werden vom BIR-Ersteller nicht unterstützt. -
CreationDate
-
Das Datum und die Uhrzeit in koordinierte Weltzeit (Greenwich Mean Time), zu der das BIR erstellt wurde.
-
ValidityPeriod
-
Der Zeitraum, für den das BIR gültig ist.
-
BeginDate
-
Das Datum und die Uhrzeit in koordinierte Weltzeit Gültigkeitsdauer.
-
EndDate
-
Das Datum und die Uhrzeit in koordinierte Weltzeit, ab dem das 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 _ KEIN _ _ FORMATBESITZER _ VERFÜGBAR
- ((USHORT)0)
Es wurde kein IBIA-Besitzerwert (International Biometric Industry Association) angegeben. - WINBIO _ KEIN _ _ FORMATTYP _ VERFÜGBAR
- ((USHORT)0)
Es wurde kein Formattyp angegeben. -
ProductId
-
Eine WINBIO _ REGISTERED _ FORMAT-Struktur, die die Produkt-ID der Komponente angibt, die den Standarddatenblock im BIR generiert hat. Die WINBIO _ REGISTERED _ FORMAT-Member können 0 (null) sein.
Bemerkungen
Der Parameter Subtype gibt den Unterfaktor an, der den biometrischen Daten zugeordnet ist. Derzeit unterstützt das Windows Biometric Framework (WBF) nur die Fingerabdruckerfassung und verwendet die folgenden Konstanten, um Untergeordnete Typinformationen zu darstellen:
- 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 _ LSFINGER _
- WINBIO _ ANSI _ 381 _ POS _ _ LENK-ZEIGEFINGER _
- WINBIO _ ANSI _ 381 _ POS _ _ LENK-MITTELFINGER _
- WINBIO _ ANSI _ 381 _ POS _ _ LN-RINGFINGER _
- WINBIO _ ANSI _ 381 _ POS _ LH _ LITTLE _ FINGER
- WINBIO _ ANSI _ 381 _ POS RH MIT VIER _ _ _ FINGERN
- WINBIO _ ANSI _ 381 _ POS _ _ 4 _ FINGER
- WINBIO _ ANSI _ 381 _ POS ZWEI _ _ DAUMEN
Wichtig
Versuchen Sie nicht, den für den Subtype-Parameterwert angegebenen Wert zu überprüfen. Der Windows Biometriedienst ü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 angegeben 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 )
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 7 [ Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server 2008 [ R2-Desktop-Apps] |
| Header |
|