Share via

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 [仅限桌面应用]
标头
Winbio_types.h (包括 Winbio.h)

另请参阅

客户端应用程序结构

WinBioRegisterEventMonitor