WINBIO_BIR_HEADER structure
La structure WINBIO_BIR_HEADER contient l’en-tête d’un enregistrement d’informations biométriques (BIR).
Syntaxe
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;
Membres
-
ValidFields
-
Masque de bits qui spécifie les champs de cette structure qui sont valides. Pour plus d’informations, consultez constantes WINBIO_BIR_FIELD.
-
HeaderVersion
-
Constante WINBIO_BIR_VERSION qui spécifie la version de l’en-tête. Les numéros de version sont des valeurs 8 bits où les quatre bits supérieurs spécifient le nombre principal et les quatre bits inférieurs spécifient le numéro de version secondaire. Actuellement, il doit s’agir d’WINBIO_CBEFF_HEADER_VERSION (0x11).
-
PatronHeaderVersion
-
Constante WINBIO_BIR_VERSION qui spécifie la version de l’en-tête. Les numéros de version sont des valeurs 8 bits où les quatre bits supérieurs spécifient le nombre principal et les quatre bits inférieurs spécifient le numéro de version secondaire. Actuellement, ce doit être WINBIO_PATRON_HEADER_VERSION (0x11).
-
DataFlags
-
Valeur qui spécifie le format des données d’en-tête. Il peut s’agir d’un or au niveau du bit des indicateurs de niveau de sécurité et de traitement suivants. Pour plus d’informations, consultez constantes WINBIO_BIR_DATA_FLAGS.
Valeur Signification - WINBIO_DATA_FLAG_PRIVACY
- ((UCHAR)0x02)
Les données sont chiffrées. - WINBIO_DATA_FLAG_INTEGRITY
- ((UCHAR)0x01)
Les données sont signées numériquement ou protégées par un code d’authentification de message (MAC). - WINBIO_DATA_FLAG_SIGNED
- ((UCHAR)0x04)
Si cet indicateur et l’indicateur WINBIO_DATA_FLAG_INTEGRITY sont définis, les données sont signées. Si cet indicateur n’est pas défini, mais que l’indicateur WINBIO_DATA_FLAG_INTEGRITY est défini, un MAC est calculé sur les données. - WINBIO_DATA_FLAG_RAW
- ((UCHAR)0x20)
Les données sont dans le format avec lequel elles ont été capturées. - WINBIO_DATA_FLAG_INTERMEDIATE
- ((UCHAR)0x40)
Les données ne sont pas brutes, mais n’ont pas été complètement traitées. - WINBIO_DATA_FLAG_PROCESSED
- ((UCHAR)0x80)
Les données ont été traitées. - WINBIO_DATA_FLAG_OPTION_MASK_PRESENT
- ((UCHAR)0x08)
Cette valeur est toujours 1. -
Type
-
Valeur WINBIO_BIOMETRIC_TYPE qui spécifie le type de données biométriques référencées dans l’enregistrement d’informations biométriques. Actuellement , seule WINBIO_TYPE_FINGERPRINT est prise en charge. Pour plus d’informations, consultez constantes WINBIO_BIOMETRIC_TYPE.
-
Sous-type
-
Valeur WINBIO_BIOMETRIC_SUBTYPE qui spécifie le sous-facteur associé aux données biométriques. Pour plus d’informations, consultez Remarques et constantes WINBIO_BIOMETRIC_SUBTYPE.
-
Objectif
-
Masque WINBIO_BIR_PURPOSE qui spécifie l’utilisation prévue des données. Il peut s’agir d’un or au niveau du bit des valeurs suivantes. Pour plus d’informations, consultez constantes 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
-
Valeur qui spécifie la qualité relative des données biométriques dans l’enregistrement d’informations biométriques (BIR). Il peut s’agir d’un entier compris entre 0 et 100 ou de l’une des valeurs suivantes. Pour plus d’informations, consultez constantes WINBIO_BIR_QUALITY.
Valeur Signification - WINBIO_DATA_QUALITY_NOT_SET
- ((WINBIO_BIR_QUALITY)-1)
Les mesures de qualité sont prises en charge par le créateur BIR, mais aucune valeur n’est définie dans le BIR. - WINBIO_DATA_QUALITY_NOT_SUPPORTED
- ((WINBIO_BIR_QUALITY)-2)
Les mesures de qualité ne sont pas prises en charge par le créateur BIR. -
CreationDate
-
Date et heure, en temps universel coordonné (Heure moyenne de Greenwich), à laquelle le BIR a été créé.
-
ValidityPeriod
-
Période pendant laquelle le BIR est valide.
-
BeginDate
-
Date et heure, en temps universel coordonné, de début de la période de validité.
-
EndDate
-
Date et heure, en temps universel coordonné, à laquelle le BIR cesse d’être valide.
-
-
BiometricDataFormat
-
Structure WINBIO_REGISTERED_FORMAT qui spécifie le format de données du bloc de données standard dans la structure WINBIO_BIR . Le WINBIO_REGISTERED_FORMAT membres ne peut pas être égal à zéro. Vous pouvez utiliser les constantes suivantes pour simplifier la vérification des erreurs.
Valeur Signification - WINBIO_NO_FORMAT_OWNER_AVAILABLE
- ((USHORT)0)
Aucune valeur de propriétaire affectée par l’IBIA (International Biometric Industry Association) n’a été spécifiée. - WINBIO_NO_FORMAT_TYPE_AVAILABLE
- ((USHORT)0)
Aucun type de format n’a été spécifié. -
ProductId
-
Structure WINBIO_REGISTERED_FORMAT qui spécifie l’ID de produit du composant qui a généré le bloc de données standard dans le BIR. Le WINBIO_REGISTERED_FORMAT membres peut être égal à zéro.
Notes
Le paramètre Subtype spécifie le sous-facteur associé aux données biométriques. Actuellement, windows Biometric Framework (WBF) prend uniquement en charge la capture d’empreintes digitales et utilise les constantes suivantes pour représenter les informations de sous-type :
- 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
Important
N’essayez pas de valider la valeur fournie pour la valeur du paramètre Subtype . Le service de biométrie Windows valide la valeur fournie avant de la transmettre à votre implémentation. Si la valeur est WINBIO_SUBTYPE_NO_INFORMATION ou WINBIO_SUBTYPE_ANY, validez le cas échéant.
Si l’un des bits suivants est affirmé, la structure WINBIO_BIR_HEADER n’est pas correctement formée.
#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 )
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2008 R2 [applications de bureau uniquement] |
| En-tête |
|