WINBIO_EVENT 结构
WINBIO_EVENT 结构包含在引发事件通知时发送到回调例程的状态信息。
语法
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;
成员
-
类型
-
一个 值，该值指定引发的服务提供程序事件通知的类型。 目前支持的唯一提供程序是指纹传感器。 此传感器支持以下标志。
-
WINBIO_EVENT_FP_UNCLAIMED (传感器检测到应用程序或当前具有焦点的窗口未请求的手指轻扫。Windows 生物识别框架调用回调函数，以指示已发生手指轻扫，但不尝试识别指纹。)
-
WINBIO_EVENT_FP_UNCLAIMED_IDENTIFY (传感器检测到应用程序或当前具有焦点的窗口未请求的手指轻扫。Windows 生物识别框架尝试识别指纹，并将该过程的结果传递给回调函数。)
-
-
参数
-
-
无人 认领
-
为生物识别样本捕获返回的结构。
-
UnitId
-
生成样本的生物识别单元。
-
RejectDetail
-
一个 ULONG 值，该值包含有关未能捕获生物识别样本的其他信息。 如果捕获成功，此参数将设置为零。 为指纹捕获定义了以下值：
- 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
-
为生物识别捕获和识别返回的结构。 标识确定样本是否可以与现有生物识别模板相关联。
-
UnitId
-
生成样本的生物识别单元。
-
标识
-
包含提供生物识别示例的用户的 GUID 或 SID 的WINBIO_IDENTITY 结构。
-
SubFactor
-
一个WINBIO_BIOMETRIC_SUBTYPE值，该值指定与生物识别样本关联的子因子。 Windows 生物识别框架 (WBF) 目前仅支持指纹捕获，并使用以下常量来表示子类型信息。
- 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
重要
不要尝试验证为 SubFactor 值提供的值。 Windows 生物识别服务将验证提供的值，然后再将其传递给实现。 如果该值 WINBIO_SUBTYPE_NO_INFORMATION 或 WINBIO_SUBTYPE_ANY，则根据需要进行验证。
-
RejectDetail
-
一个 ULONG 值，该值包含有关捕获生物识别样本失败的其他信息。 如果捕获成功，此参数将设置为零。 为指纹捕获定义了以下值：
- 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
-
-
错误
-
用于标识所监视操作的成功或失败的结构。
-
ErrorCode
-
包含S_OK或由 Windows 生物识别框架执行的计算产生的错误代码的 HRESULT 值。
-
-
备注
调用 WinBioRegisterEventMonitor 函数以注册回调例程，以接收来自 Windows 生物识别框架的事件通知。 回调是必须为应用程序定义的自定义函数。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows 7 [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2008 R2 [仅限桌面应用] |
| 标头 |
|