estrutura WINBIO_EVENT
A estrutura WINBIO_EVENT contém status informações enviadas para a rotina de retorno de chamada quando um aviso de evento é gerado.
Sintaxe
typedef struct _WINBIO_EVENT {
WINBIO_EVENT_TYPE Type;
union {
struct {
WINBIO_UNIT_ID UnitId;
WINBIO_REJECT_DETAIL RejectDetail;
} Unclaimed;
struct {
WINBIO_UNIT_ID UnitId;
WINBIO_IDENTITY Identity;
WINBIO_BIOMETRIC_SUBTYPE SubFactor;
WINBIO_REJECT_DETAIL RejectDetail;
} UnclaimedIdentify;
struct {
HRESULT ErrorCode;
} Error;
} Parameters;
} WINBIO_EVENT, *PWINBIO_EVENT;
Membros
-
Tipo
-
Um valor que especifica o tipo de aviso de evento do provedor de serviços gerado. O único provedor com suporte no momento é o sensor de impressão digital. Esse sensor dá suporte aos sinalizadores a seguir.
-
WINBIO_EVENT_FP_UNCLAIMED (O sensor detectou um dedo que não foi solicitado pelo aplicativo ou pela janela que tem foco no momento. A Estrutura Biométrica do Windows chama sua função de retorno de chamada para indicar que ocorreu um dedo, mas não tenta identificar a impressão digital.)
-
WINBIO_EVENT_FP_UNCLAIMED_IDENTIFY (O sensor detectou um dedo que não foi solicitado pelo aplicativo ou pela janela que tem foco no momento. A Estrutura Biométrica do Windows tenta identificar a impressão digital e passa o resultado desse processo para sua função de retorno de chamada.)
-
-
Parâmetros
-
-
Unclaimed
-
Estrutura retornada para captura de amostra biométrica.
-
UnitId
-
A unidade biométrica que gerou o exemplo.
-
RejectDetail
-
Um valor ULONG que contém informações adicionais sobre falha ao capturar uma amostra biométrica. Se uma captura for bem-sucedida, esse parâmetro será definido como zero. Os seguintes valores são definidos para captura de impressão digital:
- WINBIO_FP_TOO_HIGH
- WINBIO_FP_TOO_LOW
- WINBIO_FP_TOO_LEFT
- WINBIO_FP_TOO_RIGHT
- WINBIO_FP_TOO_FAST
- WINBIO_FP_TOO_SLOW
- WINBIO_FP_POOR_QUALITY
- WINBIO_FP_TOO_SKEWED
- WINBIO_FP_TOO_SHORT
- WINBIO_FP_MERGE_FAILURE
-
-
UnclaimedIdentify
-
Estrutura retornada para captura biométrica e identificação. A identificação determina se um exemplo pode ser associado a um modelo biométrico existente.
-
UnitId
-
A unidade biométrica que gerou o exemplo.
-
Identidade
-
Uma estrutura WINBIO_IDENTITY que contém o GUID ou o SID do usuário que fornece a amostra biométrica.
-
SubFactor
-
Um valor WINBIO_BIOMETRIC_SUBTYPE que especifica o subfator associado a uma amostra biométrica. Atualmente, o WBF (Windows Biometric Framework) dá suporte apenas à captura de impressão digital e usa as constantes a seguir 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 de SubFactor . 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.
-
RejectDetail
-
Um valor ULONG que contém informações adicionais sobre a falha ao capturar uma amostra biométrica. Se a captura for bem-sucedida, esse parâmetro será definido como zero. Os seguintes valores são definidos para captura de impressão digital:
- WINBIO_FP_TOO_HIGH
- WINBIO_FP_TOO_LOW
- WINBIO_FP_TOO_LEFT
- WINBIO_FP_TOO_RIGHT
- WINBIO_FP_TOO_FAST
- WINBIO_FP_TOO_SLOW
- WINBIO_FP_POOR_QUALITY
- WINBIO_FP_TOO_SKEWED
- WINBIO_FP_TOO_SHORT
- WINBIO_FP_MERGE_FAILURE
-
-
Erro
-
Estrutura que identifica o êxito ou a falha da operação que está sendo monitorada.
-
ErrorCode
-
Valor HRESULT que contém S_OK ou um código de erro resultante de cálculos executados pela Estrutura Biométrica do Windows.
-
-
Comentários
Chame a função WinBioRegisterEventMonitor para registrar uma rotina de retorno de chamada para receber notificações de eventos da Estrutura Biométrica do Windows. O retorno de chamada é uma função personalizada que você deve definir para seu aplicativo.
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 |
|