Leer en inglés

Compartir a través de


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
Winbio_types.h (incluya Winbio.h)

Consulte también

Estructuras de aplicación cliente

constantes de WINBIO_BIOMETRIC_SUBTYPE

WINBIO_BIR

constantes de WINBIO_BIR_DATA_FLAGS

constantes de WINBIO_BIR_FIELD

constantes de WINBIO_BIR_PURPOSE

constantes de WINBIO_BIR_QUALITY

constantes de WINBIO_BIR_VERSION