WINBIO_BIR_HEADER struttura
La struttura WINBIO_BIR_HEADER contiene l'intestazione di un record di informazioni biometriche (BIR).
Sintassi
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
-
Maschera bit che specifica quali campi in questa struttura sono validi. Per altre informazioni, vedere Costanti WINBIO_BIR_FIELD.
-
HeaderVersion
-
Costante WINBIO_BIR_VERSION che specifica la versione dell'intestazione. I numeri di versione sono valori a 8 bit in cui i quattro bit superiori specificano il numero principale e i quattro bit bassi specificano il numero di versione secondaria. Attualmente deve essere WINBIO_CBEFF_HEADER_VERSION (0x11).
-
PatronHeaderVersion
-
Costante WINBIO_BIR_VERSION che specifica la versione dell'intestazione. I numeri di versione sono valori a 8 bit in cui i quattro bit superiori specificano il numero principale e i quattro bit bassi specificano il numero di versione secondaria. Attualmente deve essere WINBIO_PATRON_HEADER_VERSION (0x11).
-
DataFlags
-
Valore che specifica il formato dei dati dell'intestazione. Questo può essere un OR bit per bit dei flag di sicurezza e elaborazione seguenti. Per altre informazioni, vedere Costanti WINBIO_BIR_DATA_FLAGS.
Valore Significato - WINBIO_DATA_FLAG_PRIVACY
- ((UCHAR)0x02)
I dati sono crittografati. - WINBIO_DATA_FLAG_INTEGRITY
- ((UCHAR)0x01)
I dati sono firmati digitalmente o protetti da un codice di autenticazione dei messaggi (MAC). - WINBIO_DATA_FLAG_SIGNED
- ((UCHAR)0x04)
Se questo flag e il flag di WINBIO_DATA_FLAG_INTEGRITY vengono impostati, i dati vengono firmati. Se questo flag non è impostato, ma il flag di WINBIO_DATA_FLAG_INTEGRITY è impostato, viene calcolato un MAC sui dati. - WINBIO_DATA_FLAG_RAW
- ((UCHAR)0x20)
I dati sono nel formato con cui è stato acquisito. - WINBIO_DATA_FLAG_INTERMEDIATE
- ((UCHAR)0x40)
I dati non sono elaborati ma non sono stati completamente elaborati. - WINBIO_DATA_FLAG_PROCESSED
- ((UCHAR)0x80)
I dati sono stati elaborati. - WINBIO_DATA_FLAG_OPTION_MASK_PRESENT
- ((UCHAR)0x08)
Il valore è sempre 1. -
Tipo
-
Valore WINBIO_BIOMETRIC_TYPE che specifica il tipo di dati biometrici a cui fa riferimento nel record di informazioni biometriche. Attualmente è supportato solo WINBIO_TYPE_FINGERPRINT . Per altre informazioni, vedere Costanti WINBIO_BIOMETRIC_TYPE.
-
Sottotipo
-
Valore WINBIO_BIOMETRIC_SUBTYPE che specifica il sotto-fattore associato ai dati biometrici. Per altre informazioni, vedere Osservazioni e costanti WINBIO_BIOMETRIC_SUBTYPE.
-
Scopo
-
Maschera WINBIO_BIR_PURPOSE che specifica l'uso previsto dei dati. Questo può essere un OR bit per bit dei valori seguenti. Per altre informazioni, vedere Costanti 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
-
Valore che specifica la qualità relativa dei dati biometrici nel record di informazioni biometriche (BIR). Può trattarsi di un numero intero compreso tra 0 e 100 o uno dei valori seguenti. Per altre informazioni, vedere costanti WINBIO_BIR_QUALITY.
Valore Significato - WINBIO_DATA_QUALITY_NOT_SET
- ((WINBIO_BIR_QUALITY)-1)
Le misurazioni di qualità sono supportate dall'autore BIR, ma non viene impostato alcun valore nella BIR. - WINBIO_DATA_QUALITY_NOT_SUPPORTED
- ((WINBIO_BIR_QUALITY)-2)
Le misurazioni di qualità non sono supportate dal creatore BIR. -
CreationDate
-
Data e ora, in Coordinated Universal Time (Greenwich Mean Time), creata dalla BIR.
-
ValidityPeriod
-
Periodo per il quale il BIR è valido.
-
Begindate
-
Data e ora, in Coordinated Universal Time, che inizia il periodo di validità.
-
EndDate
-
La data e l'ora, in Coordinated Universal Time, in cui il BIR smette di essere valido.
-
-
BiometricDataFormat
-
Struttura WINBIO_REGISTERED_FORMAT che specifica il formato dei dati del blocco di dati standard nella struttura WINBIO_BIR . I membri WINBIO_REGISTERED_FORMAT non possono essere zero. È possibile usare le costanti seguenti per semplificare il controllo degli errori.
Valore Significato - WINBIO_NO_FORMAT_OWNER_AVAILABLE
- ((USHORT)0)
Non è stato specificato alcun valore proprietario assegnato da IBIA (International Biometric Industry Association). - WINBIO_NO_FORMAT_TYPE_AVAILABLE
- ((USHORT)0)
Non è stato specificato alcun tipo di formato. -
ProductId
-
Struttura WINBIO_REGISTERED_FORMAT che specifica l'ID prodotto del componente che ha generato il blocco di dati standard in BIR. I membri WINBIO_REGISTERED_FORMAT possono essere zero.
Commenti
Il parametro Subtype specifica il sotto-fattore associato ai dati biometrici. Attualmente, Windows Biometric Framework (WBF) supporta solo l'acquisizione delle impronte digitali e usa le costanti seguenti per rappresentare informazioni di sottotipo:
- 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
Importante
Non tentare di convalidare il valore fornito per il valore del parametro Subtype . Il servizio Windows Biometrics convaliderà il valore fornito prima di passarlo all'implementazione. Se il valore è WINBIO_SUBTYPE_NO_INFORMATION o WINBIO_SUBTYPE_ANY, convalidare la posizione appropriata.
Se vengono asserti uno dei bit seguenti, la struttura WINBIO_BIR_HEADER non viene formata correttamente.
#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 )
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 7 [solo app desktop] |
| Server minimo supportato |
Windows Server 2008 R2 [solo app desktop] |
| Intestazione |
|