Функция WinBioMonitorPresence (winbio.h)

Статья
08/27/2023

Включает механизм распознавания лиц или мониторинга радужной оболочки глаза для указанной биометрической единицы. Начиная с 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 с элементом Operation , равным WINBIO_OPERATION_MONITOR_PRESENCE. Затем следует изучить элемент Parameters.MonitorPresence структуры WINBIO_ASYNC_RESULT для получения дополнительных сведений.

Чтобы прекратить получение уведомлений, вызовите WinBioCancel или WinBioCloseSession с исходным значением асинхронного дескриптора.

Требования


Минимальная версия клиента	Windows 10 [только классические приложения]
Минимальная версия сервера	Windows Server 2016 [только классические приложения]
Целевая платформа	Windows
Header	winbio.h
Библиотека	Winbio.lib
DLL	Winbio.dll

См. также раздел

WINBIO_ASYNC_RESULT

WinBioAsyncOpenSession

WinBioCancel

WinBioCloseSession

Share via