Share via

WinBioAsyncMonitorFrameworkChanges 函数 (winbio.h)

  • 项目

启动对生物识别框架的更改的异步监视器。 目前，当生物识别单元连接到计算机或从计算机中分离时，仅发生受监视的更改。

语法

HRESULT WinBioAsyncMonitorFrameworkChanges(
  [in] WINBIO_FRAMEWORK_HANDLE      FrameworkHandle,
  [in] WINBIO_FRAMEWORK_CHANGE_TYPE ChangeTypes
);

参数

[in] FrameworkHandle

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

[in] ChangeTypes

类型的位掩码 WINBIO_FRAMEWORK_CHANGE_TYPE 标志，指示应生成异步通知的事件类型。 从 Windows 8 开始，可以使用以下标志：

值 含义
WINBIO_FRAMEWORK_CHANGE_UNIT
 生物识别单元已连接到计算机或从计算机中分离。

返回值

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

返回代码 说明
E_HANDLE
 必须设置 FrameworkHandle 参数。
E_INVALIDARG
 ChangeTypes 参数中包含的位掩码包含一个或多个无效类型位。 目前，唯一可用的值是 WINBIO_FRAMEWORK_CHANGE_UNIT。
WINBIO_E_INCORRECT_SESSION_TYPE
 FrameworkHandle 参数必须表示异步框架会话。

注解

启动后，此监视器将继续生成事件，直到客户端应用程序调用 WinBioCancel 或 WinBioCloseFramework。 为 WINBIO_FRAMEWORK_CHANGE_UNIT 事件创建监视器将生成两种类型的异步通知：

值 含义
WINBIO_OPERATION_UNIT_ARRIVAL 附加了生物识别单元。
WINBIO_OPERATION_UNIT_REMOVAL 分离生物识别单元。
 

WinBioAsyncMonitorFrameworkChanges 函数使用通过调用 WinBioAsyncOpenFramework 打开的框架会话的句柄。 框架分配 WINBIO_ASYNC_RESULT 结构，并使用它来返回有关操作成功或失败的信息。 如果生物识别单元连接到计算机或从计算机中分离，框架将设置结构的 Operation 成员。 如果在操作过程中遇到问题，框架将使用 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 结构中的 EnumServiceProviders 结构中返回。 使用完WINBIO_ASYNC_RESULT结构后，必须调用 WinBioFree 才能释放它。

要求

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

另请参阅

WinBioAsyncOpenFramework