WinBioAsyncEnumDatabases 函数 (winbio.h)

异步枚举与指定类型匹配的所有已注册数据库。 有关此函数的同步版本,请参阅 WinBioEnumDatabases

语法

HRESULT WinBioAsyncEnumDatabases(
  [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_INCORRECT_SESSION_TYPE
FrameworkHandle 参数必须表示异步框架会话。

注解

WinBioAsyncEnumDatabases 函数使用通过调用 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 结构中的 EnumDatabases 结构中返回。 使用完WINBIO_ASYNC_RESULT结构后,必须调用 WinBioFree 来释放它。

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

要求

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

另请参阅

WinBioAsyncOpenFramework