WinBioAsyncEnumBiometricUnits 函数 (winbio.h)

异步枚举与输入因子类型匹配的所有附加生物识别单元。 有关此函数的同步版本,请参阅 WinBioEnumBiometricUnits。 从 Windows 10 版本 1607 开始,此函数可用于移动映像。

语法

HRESULT WinBioAsyncEnumBiometricUnits(
  [in] WINBIO_FRAMEWORK_HANDLE FrameworkHandle,
  [in] WINBIO_BIOMETRIC_TYPE   Factor
);

参数

[in] FrameworkHandle

通过调用 WinBioAsyncOpenFramework 打开的框架会话的句柄。

[in] Factor

WINBIO_BIOMETRIC_TYPE标志的位掩码,指定要枚举的生物识别单元类型。 目前仅支持 WINBIO_TYPE_FINGERPRINT

返回值

函数返回指示成功或失败的 HRESULT 。 请注意,成功仅指示参数有效。 在执行操作期间遇到的故障将使用对 WinBioAsyncOpenFramework 的调用中指定的通知方法以异步方式返回到WINBIO_ASYNC_RESULT结构。

返回代码 说明
E_HANDLE
必须设置 FrameworkHandle 参数。
E_INVALIDARG
Factor 参数中包含的位掩码包含一个或多个无效类型位。
E_OUTOFMEMORY
内存不足,无法完成请求。
WINBIO_E_DISABLED
当前管理策略禁止使用 Windows 生物识别框架 API。
WINBIO_E_INCORRECT_SESSION_TYPE
FrameworkHandle 参数必须表示异步框架会话。
WINBIO_E_SESSION_HANDLE_CLOSED
会话句柄已标记为关闭。

注解

WinBioAsyncEnumBiometricUnits 函数使用通过调用 WinBioAsyncOpenFramework 打开的框架会话的句柄。 框架分配 WINBIO_ASYNC_RESULT 结构,并使用它来返回有关操作成功或失败的信息。 如果枚举操作成功,框架将返回架构数组,其中包含有关每个枚举生物识别单元的信息。 如果操作不成功,框架将使用 WINBIO_ASYNC_RESULT 结构返回错误信息。 结构将返回到应用程序回调或应用程序消息队列,具体取决于在 WinBioAsyncOpenFramework 函数的 NotificationMethod 参数中设置的值。

  • 如果选择使用回调接收完成通知,则必须实现 PWINBIO_ASYNC_COMPLETION_CALLBACK 函数并将 NotificationMethod 参数设置为 WINBIO_ASYNC_NOTIFY_CALLBACK
  • 如果选择使用应用程序消息队列接收完成通知,则必须将 NotificationMethod 参数设置为 WINBIO_ASYNC_NOTIFY_MESSAGE。 框架返回指向窗口消息的 LPARAM 字段的WINBIO_ASYNC_RESULT指针。
架构数组以嵌套在 WINBIO_ASYNC_RESULT 结构内的 EnumBiometricUnits 结构中返回。 使用完WINBIO_ASYNC_RESULT结构后,必须调用 WinBioFree 才能释放它。

调用 WinBioAsyncEnumBiometricUnits 会导致将单个通知发送到客户端应用程序。

要求

   
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 winbio.h (包括 Winbio.h)
Library Winbio.lib
DLL Winbio.dll

另请参阅

WinBioAsyncOpenFramework