estructura de WINBIO_EVENT
La estructura de WINBIO_EVENT contiene información de estado enviada a la rutina de devolución de llamada cuando se genera un aviso de evento.
Sintaxis
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;
Miembros
-
Tipo
-
Valor que especifica el tipo de aviso de evento del proveedor de servicios generado. El único proveedor admitido actualmente es el sensor de huella digital. Este sensor admite las marcas siguientes.
-
WINBIO_EVENT_FP_UNCLAIMED (el sensor detectó un dedo que la aplicación no solicitó o la ventana que actualmente tiene el foco. Windows Biometric Framework llama a la función de devolución de llamada para indicar que se ha producido un dedo dedo, pero no intenta identificar la huella digital).
-
WINBIO_EVENT_FP_UNCLAIMED_IDENTIFY (el sensor detectó un dedo que la aplicación no solicitó o la ventana que actualmente tiene el foco. Windows Biometric Framework intenta identificar la huella digital y pasa el resultado de ese proceso a la función de devolución de llamada).
-
-
Parámetros
-
-
Sin reclamar
-
Estructura devuelta para la captura de muestra biométrica.
-
UnitId
-
Unidad biométrica que generó la muestra.
-
RejectDetail
-
Valor ULONG que contiene información adicional sobre el error al capturar una muestra biométrica. Si una captura se realizó correctamente, este parámetro se establece en cero. Los valores siguientes se definen para la captura de huellas digitales:
- 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
-
Estructura devuelta para la captura e identificación biométricas. La identificación determina si una muestra se puede asociar a una plantilla biométrica existente.
-
UnitId
-
Unidad biométrica que generó la muestra.
-
Identidad
-
Estructura WINBIO_IDENTITY que contiene el GUID o el SID del usuario que proporciona la muestra biométrica.
-
SubFactor
-
Valor de WINBIO_BIOMETRIC_SUBTYPE que especifica el subfactor asociado a una muestra biométrica. Windows Biometric Framework (WBF) actualmente 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 subfactor . 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.
-
RejectDetail
-
Valor de ULONG que contiene información adicional sobre el error de captura de una muestra biométrica. Si la captura se realizó correctamente, este parámetro se establece en cero. Los valores siguientes se definen para la captura de huellas digitales:
- 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
-
-
Error
-
Estructura que identifica el éxito o error de la operación que se está supervisando.
-
ErrorCode
-
Valor HRESULT que contiene S_OK o un código de error resultante de cálculos realizados por Windows Biometric Framework.
-
-
Comentarios
Llame a la función WinBioRegisterEventMonitor para registrar una rutina de devolución de llamada para recibir notificaciones de eventos de Windows Biometric Framework. La devolución de llamada es una función personalizada que debe definir para la aplicación.
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 |
|