WINBIO_EVENT structure
The WINBIO_EVENT structure contains status information sent to the callback routine when an event notice is raised.
Syntax
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;
Members
-
Type
-
A value that specifies the type of service provider event notice raised. The only provider currently supported is the fingerprint sensor. This sensor supports the following flags.
-
WINBIO_EVENT_FP_UNCLAIMED (The sensor detected a finger swipe that was not requested by the application or by the window that currently has focus. The Windows Biometric Framework calls into your callback function to indicate that a finger swipe has occurred but does not try to identify the fingerprint.)
-
WINBIO_EVENT_FP_UNCLAIMED_IDENTIFY (The sensor detected a finger swipe that was not requested by the application or by the window that currently has focus. The Windows Biometric Framework attempts to identify the fingerprint and passes the result of that process to your callback function.)
-
-
Parameters
-
-
Unclaimed
-
Structure returned for biometric sample capture.
-
UnitId
-
The biometric unit that generated the sample.
-
RejectDetail
-
A ULONG value that contains additional information regarding failure to capture a biometric sample. If a capture succeeded, this parameter is set to zero. The following values are defined for fingerprint capture:
- 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
-
Structure returned for biometric capture and identification. Identification determines whether a sample can be associated with an existing biometric template.
-
UnitId
-
The biometric unit that generated the sample.
-
Identity
-
A WINBIO_IDENTITY structure that contains the GUID or SID of the user providing the biometric sample.
-
SubFactor
-
A WINBIO_BIOMETRIC_SUBTYPE value that specifies the sub-factor associated with a biometric sample. The Windows Biometric Framework (WBF) currently supports only fingerprint capture and uses the following constants to represent sub-type information.
- 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
Important
Do not attempt to validate the value supplied for the SubFactor value. The Windows Biometrics Service will validate the supplied value before passing it through to your implementation. If the value is WINBIO_SUBTYPE_NO_INFORMATION or WINBIO_SUBTYPE_ANY, then validate where appropriate.
-
RejectDetail
-
A ULONG value that contains additional information about the failure to capture a biometric sample. If the capture succeeded, this parameter is set to zero. The following values are defined for fingerprint capture:
- 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
-
Structure that identifies the success or failure of the operation being monitored.
-
ErrorCode
-
HRESULT value that contains S_OK or an error code that resulted from computations performed by the Windows Biometric Framework.
-
-
Remarks
Call the WinBioRegisterEventMonitor function to register a callback routine to receive event notifications from the Windows Biometric Framework. The callback is a custom function that you must define for your application.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 7 [desktop apps only] |
| Minimum supported server |
Windows Server 2008 R2 [desktop apps only] |
| Header |
|