Share via

winBioMonitorPresence 函数 (winbio.h)

  • 项目

打开指定生物识别单元的人脸识别或虹膜监视机制。 从 Windows 10 版本 1607 开始，此函数可用于移动映像。

语法

HRESULT WinBioMonitorPresence(
  [in] WINBIO_SESSION_HANDLE SessionHandle,
  [in] WINBIO_UNIT_ID        UnitId
);

参数

[in] SessionHandle

通过调用 WinBioAsyncOpenSession 函数获取的生物识别会话的异步句柄， 并将 PoolType 参数设置为 WINBIO_POOL_SYSTEM。

[in] UnitId

要为其启用人脸识别或虹膜监视机制的生物识别单元的标识符。

返回值

如果函数参数是可接受的，则返回 S_OK。 如果函数参数不可接受，则返回指示错误的 HRESULT 值。
可能的值包括（但并不限于）下表中的项。 有关常见错误代码的列表，请参阅 常见 HRESULT 值。

返回代码 说明
E_HANDLE
 会话句柄无效。
E_INVALIDARG
 UnitId 参数不能等于零。
WINBIO_E_INCORRECT_SESSION_TYPE
 会话句柄与异步生物识别会话不对应。
 

操作本身的实际成功或失败将返回到 WINBIO_ASYNC_RESULT 结构中的通知函数。

注解

一个生物识别会话在任何时间点只能有一个活动状态监视器。

成功调用 WinBioMonitorPresence 后，通知函数将接收 WINBIO_ASYNC_RESULT 结构形式的通知， 操作 成员等于 WINBIO_OPERATION_MONITOR_PRESENCE。 然后，应检查 WINBIO_ASYNC_RESULT 结构的 Parameters.MonitorPresence 成员以获取详细信息。

若要停止接收通知，请使用原始异步句柄值调用 WinBioCancel 或 WinBioCloseSession 。

要求

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

另请参阅

WINBIO_ASYNC_RESULT

WinBioAsyncOpenSession

WinBioCancel

WinBioCloseSession