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 值。
| 返回代码 | 说明 |
|---|---|
|
会话句柄无效。 |
|
UnitId 参数不能等于零。 |
|
会话句柄与异步生物识别会话不对应。 |
操作本身的实际成功或失败将返回到 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 |