estrutura WINBIO_BIR_HEADER
A estrutura WINBIO_BIR_HEADER contém o cabeçalho de um BIR (registro de informações biométricas).
Sintaxe
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;
Membros
-
ValidFields
-
Bitmask que especifica quais campos nessa estrutura são válidos. Para obter mais informações, consulte Constantes WINBIO_BIR_FIELD.
-
HeaderVersion
-
Uma constante WINBIO_BIR_VERSION que especifica a versão do cabeçalho. Os números de versão são valores de 8 bits em que os quatro bits superiores especificam o número principal e os quatro bits baixos especificam o número de versão secundária. Atualmente, isso deve ser WINBIO_CBEFF_HEADER_VERSION (0x11).
-
PatronHeaderVersion
-
Uma constante WINBIO_BIR_VERSION que especifica a versão do cabeçalho. Os números de versão são valores de 8 bits em que os quatro bits superiores especificam o número principal e os quatro bits baixos especificam o número de versão secundária. Atualmente, isso deve ser WINBIO_PATRON_HEADER_VERSION (0x11).
-
DataFlags
-
Um valor que especifica o formato dos dados de cabeçalho. Isso pode ser um OR bit a bit dos sinalizadores de nível de segurança e processamento a seguir. Para obter mais informações, consulte Constantes WINBIO_BIR_DATA_FLAGS.
Valor Significado - WINBIO_DATA_FLAG_PRIVACY
- ((UCHAR)0x02)
Os dados estão criptografados. - WINBIO_DATA_FLAG_INTEGRITY
- ((UCHAR)0x01)
Os dados são assinados digitalmente ou protegidos por um MAC (código de autenticação de mensagem). - WINBIO_DATA_FLAG_SIGNED
- ((UCHAR)0x04)
Se esse sinalizador e o sinalizador WINBIO_DATA_FLAG_INTEGRITY estiverem definidos, os dados serão assinados. Se esse sinalizador não estiver definido, mas o sinalizador WINBIO_DATA_FLAG_INTEGRITY estiver definido, um MAC será calculado sobre os dados. - WINBIO_DATA_FLAG_RAW
- ((UCHAR)0x20)
Os dados estão no formato com o qual foram capturados. - WINBIO_DATA_FLAG_INTERMEDIATE
- ((UCHAR)0x40)
Os dados não são brutos, mas não foram completamente processados. - WINBIO_DATA_FLAG_PROCESSED
- ((UCHAR)0x80)
Os dados foram processados. - WINBIO_DATA_FLAG_OPTION_MASK_PRESENT
- ((UCHAR)0x08)
Esse valor é sempre 1. -
Tipo
-
Um valor WINBIO_BIOMETRIC_TYPE que especifica o tipo de dados biométricos referenciados no registro de informações biométricas. Atualmente, há suporte apenas para WINBIO_TYPE_FINGERPRINT . Para obter mais informações, consulte Constantes WINBIO_BIOMETRIC_TYPE.
-
Subtipo
-
Um valor WINBIO_BIOMETRIC_SUBTYPE que especifica o subfator associado aos dados biométricos. Para obter mais informações, consulte Comentários e constantes de WINBIO_BIOMETRIC_SUBTYPE.
-
Finalidade
-
Uma máscara de WINBIO_BIR_PURPOSE que especifica o uso pretendido dos dados. Isso pode ser um OR bit a bit dos valores a seguir. Para obter mais informações, consulte 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
-
Um valor que especifica a qualidade relativa dos dados biométricos no BIR (registro de informações biométricas). Isso pode ser um inteiro de 0 a 100 ou um dos valores a seguir. Para obter mais informações, consulte Constantes WINBIO_BIR_QUALITY.
Valor Significado - WINBIO_DATA_QUALITY_NOT_SET
- ((WINBIO_BIR_QUALITY)-1)
As medidas de qualidade são compatíveis com o criador do BIR, mas nenhum valor é definido no BIR. - WINBIO_DATA_QUALITY_NOT_SUPPORTED
- ((WINBIO_BIR_QUALITY)-2)
As medidas de qualidade não são compatíveis com o criador do BIR. -
CreationDate
-
A data e a hora, em Tempo Universal Coordenado (Horário de Greenwich), que o BIR foi criado.
-
ValidityPeriod
-
O período para o qual o BIR é válido.
-
BeginDate
-
A data e a hora, em Tempo Universal Coordenado, que o período de validade é iniciado.
-
EndDate
-
A data e a hora, no Tempo Universal Coordenado, em que o BIR deixa de ser válido.
-
-
BiometricDataFormat
-
Uma estrutura WINBIO_REGISTERED_FORMAT que especifica o formato de dados do bloco de dados padrão na estrutura WINBIO_BIR . Os membros WINBIO_REGISTERED_FORMAT não podem ser zero. Você pode usar as constantes a seguir para simplificar a verificação de erros.
Valor Significado - WINBIO_NO_FORMAT_OWNER_AVAILABLE
- ((USHORT)0)
Nenhum valor de proprietário atribuído à IBIA (Associação Internacional da Indústria Biométrica) foi especificado. - WINBIO_NO_FORMAT_TYPE_AVAILABLE
- ((USHORT)0)
Nenhum tipo de formato foi especificado. -
ProductId
-
Uma estrutura WINBIO_REGISTERED_FORMAT que especifica a ID do produto do componente que gerou o bloco de dados padrão no BIR. Os membros WINBIO_REGISTERED_FORMAT podem ser zero.
Comentários
O parâmetro Subtype especifica o subfator associado aos dados biométricos. Atualmente, o WBF (Windows Biometric Framework) dá suporte apenas à captura de impressão digital e usa as seguintes constantes para representar informações 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
Não tente validar o valor fornecido para o valor do parâmetro Subtype . O Serviço de Biometria do Windows validará o valor fornecido antes de passá-lo para sua implementação. Se o valor for WINBIO_SUBTYPE_NO_INFORMATION ou WINBIO_SUBTYPE_ANY, valide quando apropriado.
Se qualquer um dos bits a seguir for declarado, a estrutura WINBIO_BIR_HEADER não será formada corretamente.
#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 | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|