Função WinBioMonitorPresence (winbio.h)

  • Artigo

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
E_HANDLE
 O identificador de sessão não é válido.
E_INVALIDARG
 O parâmetro UnitId não pode ser igual a zero.
WINBIO_E_INCORRECT_SESSION_TYPE
 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

Confira também

WINBIO_ASYNC_RESULT

WinBioAsyncOpenSession

WinBioCancel

WinBioCloseSession