Função WinBioMonitorPresence (winbio.h)
Ativa o mecanismo de reconhecimento facial ou de monitoramento de íris para a unidade biométrica especificada. A partir do Windows 10, build 1607, essa função está disponível para uso com uma imagem móvel.
Sintaxe
HRESULT WinBioMonitorPresence(
[in] WINBIO_SESSION_HANDLE SessionHandle,
[in] WINBIO_UNIT_ID UnitId
);
Parâmetros
[in] SessionHandle
Um identificador assíncrono para a sessão biométrica obtida chamando a função WinBioAsyncOpenSession com o parâmetro PoolType definido como WINBIO_POOL_SYSTEM.
[in] UnitId
O identificador da unidade biométrica para a qual você deseja ativar o mecanismo de reconhecimento facial ou de monitoramento de íris.
Valor retornado
Se os parâmetros de função forem aceitáveis, ele retornará S_OK. Se os parâmetros de função não forem aceitáveis, ele retornará um valor HRESULT que indica o erro.
Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.
| Código de retorno | Descrição |
|---|---|
|
O identificador de sessão não é válido. |
|
O parâmetro UnitId não pode ser igual a zero. |
|
O identificador de sessão não corresponde a uma sessão biométrica assíncrona. |
O êxito ou falha real da operação em si é retornado para a função de notificação em uma estrutura WINBIO_ASYNC_RESULT .
Comentários
Uma única sessão biométrica pode ter apenas um monitor de presença ativo a qualquer momento.
Depois que você chamar WinBioMonitorPresence com êxito, sua função de notificação receberá notificações na forma de uma estrutura de WINBIO_ASYNC_RESULT com um membro operation igual a WINBIO_OPERATION_MONITOR_PRESENCE. Em seguida, você deve examinar o membro Parameters.MonitorPresence da estrutura WINBIO_ASYNC_RESULT para obter mais informações.
Para parar de receber notificações, chame WinBioCancel ou WinBioCloseSession com o valor de identificador assíncrono original.
Requisitos
| Cliente mínimo com suporte | Windows 10 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2016 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winbio.h |
| Biblioteca | Winbio.lib |
| DLL | Winbio.dll |