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
Winbio _ types.h (einschließlich Winbio.h)

Weitere Informationen

Clientanwendungsstrukturen

WINBIO _ BIOMETRIC _ SUBTYPE-Konstanten

WINBIO _ BIR

WINBIO _ BIR _ DATA _ FLAGS-Konstanten

WINBIO _ BIR _ FIELD-Konstanten

WINBIO _ BIR _ PURPOSE-Konstanten

WINBIO _ BIR _ QUALITY-Konstanten

WINBIO _ _ BIR-VERSIONSkonst constants