通过

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