Función WinBioMonitorPresence (winbio.h)
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 |
---|---|
|
El identificador de sesión no es válido. |
|
El parámetro UnitId no puede ser igual a cero. |
|
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 |