estructura de WINBIO_BIR_HEADER
La estructura WINBIO_BIR_HEADER contiene el encabezado de un registro de información biométrica (BIR).
Sintaxis
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;
Miembros
-
ValidFields
-
Máscara de bits que especifica qué campos de esta estructura son válidos. Para obtener más información, vea WINBIO_BIR_FIELD Constantes.
-
HeaderVersion
-
Constante WINBIO_BIR_VERSION que especifica la versión del encabezado. Los números de versión son valores de 8 bits donde los cuatro bits superiores especifican el número principal y los cuatro bits bajos especifican el número de versión secundaria. Actualmente, debe ser WINBIO_CBEFF_HEADER_VERSION (0x11).
-
PatronHeaderVersion
-
Constante WINBIO_BIR_VERSION que especifica la versión del encabezado. Los números de versión son valores de 8 bits donde los cuatro bits superiores especifican el número principal y los cuatro bits bajos especifican el número de versión secundaria. Actualmente debe ser WINBIO_PATRON_HEADER_VERSION (0x11).
-
DataFlags
-
Valor que especifica el formato de los datos de encabezado. Puede ser un OR bit a bit de las siguientes marcas de nivel de seguridad y procesamiento. Para obtener más información, vea WINBIO_BIR_DATA_FLAGS Constantes.
Valor Significado - WINBIO_DATA_FLAG_PRIVACY
- ((UCHAR)0x02)
Los datos se cifran. - WINBIO_DATA_FLAG_INTEGRITY
- ((UCHAR)0x01)
Los datos están firmados digitalmente o protegidos por un código de autenticación de mensajes (MAC). - WINBIO_DATA_FLAG_SIGNED
- ((UCHAR)0x04)
Si se establece esta marca y la marca WINBIO_DATA_FLAG_INTEGRITY , se firman los datos. Si no se establece esta marca, pero se establece la marca WINBIO_DATA_FLAG_INTEGRITY , se calcula un MAC sobre los datos. - WINBIO_DATA_FLAG_RAW
- ((UCHAR)0x20)
Los datos están en el formato con el que se capturó. - WINBIO_DATA_FLAG_INTERMEDIATE
- ((UCHAR)0x40)
Los datos no son sin procesar, pero no se han procesado por completo. - WINBIO_DATA_FLAG_PROCESSED
- ((UCHAR)0x80)
Los datos se han procesado. - WINBIO_DATA_FLAG_OPTION_MASK_PRESENT
- ((UCHAR)0x08)
Este valor siempre es 1. -
Tipo
-
Valor de WINBIO_BIOMETRIC_TYPE que especifica el tipo de datos biométricos a los que se hace referencia en el registro de información biométrica. Actualmente solo se admiten WINBIO_TYPE_FINGERPRINT . Para obtener más información, vea WINBIO_BIOMETRIC_TYPE Constantes.
-
Subtipo
-
Valor WINBIO_BIOMETRIC_SUBTYPE que especifica el subfactor asociado a los datos biométricos. Para obtener más información, vea Comentarios y WINBIO_BIOMETRIC_SUBTYPE constantes.
-
Propósito
-
Máscara de WINBIO_BIR_PURPOSE que especifica el uso previsto de los datos. Puede ser un OR bit a bit de los valores siguientes. Para obtener más información, vea WINBIO_BIR_PURPOSE Constantes.
- WINBIO_PURPOSE_VERIFY
- WINBIO_PURPOSE_IDENTIFY
- WINBIO_PURPOSE_ENROLL
- WINBIO_PURPOSE_ENROLL_FOR_VERIFICATION
- WINBIO_PURPOSE_ENROLL_FOR_IDENTIFICATION
- WINBIO_PURPOSE_AUDIT
-
DataQuality
-
Valor que especifica la calidad relativa de los datos biométricos en el registro de información biométrica (BIR). Puede ser un entero comprendido entre 0 y 100 o uno de los valores siguientes. Para obtener más información, vea WINBIO_BIR_QUALITY Constantes.
Valor Significado - WINBIO_DATA_QUALITY_NOT_SET
- ((WINBIO_BIR_QUALITY)-1)
Las mediciones de calidad son compatibles con el creador de BIR, pero no se establece ningún valor en el BIR. - WINBIO_DATA_QUALITY_NOT_SUPPORTED
- ((WINBIO_BIR_QUALITY)-2)
El creador de BIR no admite las mediciones de calidad. -
CreationDate
-
Fecha y hora, en hora universal coordinada (hora media de Greenwich), que se creó el BIR.
-
ValidityPeriod
-
Período para el que el BIR es válido.
-
BeginDate
-
Fecha y hora, en Hora universal coordinada, que se inicia el período de validez.
-
EndDate
-
Fecha y hora, en hora universal coordinada, en la que el BIR deja de ser válido.
-
-
BiometricDataFormat
-
Estructura WINBIO_REGISTERED_FORMAT que especifica el formato de datos del bloque de datos estándar en la estructura WINBIO_BIR . Los miembros WINBIO_REGISTERED_FORMAT no pueden ser cero. Puede usar las siguientes constantes para simplificar la comprobación de errores.
Valor Significado - WINBIO_NO_FORMAT_OWNER_AVAILABLE
- ((USHORT)0)
No se ha especificado ningún valor de propietario asignado de IBIA (International Biometric Industry Association). - WINBIO_NO_FORMAT_TYPE_AVAILABLE
- ((USHORT)0)
No se ha especificado ningún tipo de formato. -
ProductId
-
Estructura WINBIO_REGISTERED_FORMAT que especifica el identificador de producto del componente que generó el bloque de datos estándar en el BIR. Los miembros WINBIO_REGISTERED_FORMAT pueden ser cero.
Comentarios
El parámetro Subtype especifica el subfactor asociado a los datos biométricos. Actualmente, Windows Biometric Framework (WBF) solo admite la captura de huellas digitales y usa las siguientes constantes para representar información de subtipo:
- 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
No intente validar el valor proporcionado para el valor del parámetro Subtype . El servicio biométrico de Windows validará el valor proporcionado antes de pasarlo a la implementación. Si el valor es WINBIO_SUBTYPE_NO_INFORMATION o WINBIO_SUBTYPE_ANY, valide cuando corresponda.
Si se afirma alguno de los bits siguientes, la estructura WINBIO_BIR_HEADER no se forma correctamente.
#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 )
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Encabezado |
|