Share via

Función WinBioMonitorPresence (winbio.h)

  • Artículo

Activa el mecanismo de reconocimiento facial o supervisión de iris para la unidad biométrica especificada. A partir de Windows 10, compilación 1607, esta función está disponible para su uso con una imagen móvil.

Sintaxis

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

Parámetros

[in] SessionHandle

Identificador asincrónico de la sesión biométrica que obtuvo llamando a la función WinBioAsyncOpenSession con el parámetro PoolType establecido en WINBIO_POOL_SYSTEM.

[in] UnitId

Identificador de la unidad biométrica para la que desea activar el mecanismo de reconocimiento facial o supervisión de iris.

Valor devuelto

Si los parámetros de función son aceptables, devuelve S_OK. Si los parámetros de función no son aceptables, devuelve un valor HRESULT que indica el error.
Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código devuelto Descripción
E_HANDLE
 El identificador de sesión no es válido.
E_INVALIDARG
 El parámetro UnitId no puede ser igual a cero.
WINBIO_E_INCORRECT_SESSION_TYPE
 El identificador de sesión no corresponde a una sesión biométrica asincrónica.
 

El éxito real o el error de la propia operación se devuelve a la función de notificación en una estructura WINBIO_ASYNC_RESULT .

Comentarios

Una sola sesión biométrica solo puede tener un monitor de presencia activo en cualquier momento dado.

Después de llamar correctamente a WinBioMonitorPresence, la función de notificación recibe notificaciones en forma de una estructura de WINBIO_ASYNC_RESULT con un miembro Operation igual a WINBIO_OPERATION_MONITOR_PRESENCE. A continuación, debe examinar el miembro Parameters.MonitorPresence de la estructura WINBIO_ASYNC_RESULT para obtener más información.

Para dejar de recibir notificaciones, llame a WinBioCancel o WinBioCloseSession con el valor de identificador asincrónico original.

Requisitos

   
Cliente mínimo compatible Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbio.h
Library Winbio.lib
Archivo DLL Winbio.dll

Consulte también

WINBIO_ASYNC_RESULT

WinBioAsyncOpenSession

WinBioCancel

WinBioCloseSession