通过

WinBioAsyncEnumBiometricUnits 函数 （winbio.h）

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

Syntax

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结构。

返回代码 Description
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 会导致将单个通知发送到客户端应用程序。

要求

Requirement 价值
最低支持的客户端 Windows 8 [仅限桌面应用]
支持的最低服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows操作系统
Header winbio.h （包括 Winbio.h）
Library Winbio.lib
DLL Winbio.dll

另请参阅

WinBioAsyncOpenFramework

  • Last updated on