Поделиться через

Функция 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 с элементом 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