WinBioMonitorPresence 函数（winbio.h）

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

Syntax

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 值。

返回代码	Description
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 。

要求

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