Compartilhar via

Função WinBioAsyncEnumBiometricUnits (winbio.h)

  • Artigo

Enumera de forma assíncrona todas as unidades biométricas anexadas que correspondem ao tipo de fator de entrada. Para obter uma versão síncrona dessa função, consulte WinBioEnumBiometricUnits. A partir do Windows 10, build 1607, essa função está disponível para uso com uma imagem móvel.

Sintaxe

HRESULT WinBioAsyncEnumBiometricUnits(
  [in] WINBIO_FRAMEWORK_HANDLE FrameworkHandle,
  [in] WINBIO_BIOMETRIC_TYPE   Factor
);

Parâmetros

[in] FrameworkHandle

Manipule para a sessão de estrutura aberta chamando WinBioAsyncOpenFramework.

[in] Factor

Uma máscara de bits de sinalizadores de WINBIO_BIOMETRIC_TYPE que especifica os tipos de unidade biométrica a serem enumerados. Somente WINBIO_TYPE_FINGERPRINT tem suporte no momento.

Valor retornado

A função retorna um HRESULT que indica êxito ou falha. Observe que o sucesso indica apenas que os argumentos eram válidos. As falhas encontradas durante a execução da operação serão retornadas de forma assíncrona para uma estrutura WINBIO_ASYNC_RESULT usando o método de notificação especificado na chamada para WinBioAsyncOpenFramework.

Código de retorno Descrição
E_HANDLE
 Você deve definir o argumento FrameworkHandle .
E_INVALIDARG
 A máscara de bits contida no parâmetro Factor contém um ou mais bits de tipo inválidos.
E_OUTOFMEMORY
 Não havia memória suficiente para concluir a solicitação.
WINBIO_E_DISABLED
 A política administrativa atual proíbe o uso da API do Windows Biometric Framework.
WINBIO_E_INCORRECT_SESSION_TYPE
 O argumento FrameworkHandle deve representar uma sessão de estrutura assíncrona.
WINBIO_E_SESSION_HANDLE_CLOSED
 O identificador de sessão foi marcado para encerramento.

Comentários

A função WinBioAsyncEnumBiometricUnits usa um identificador para a sessão de estrutura aberta chamando WinBioAsyncOpenFramework. A estrutura aloca uma estrutura WINBIO_ASYNC_RESULT e a usa para retornar informações sobre êxito ou falha da operação. Se a operação de enumeração for bem-sucedida, a estrutura retornará uma matriz de esquemas que incluem informações sobre cada unidade biométrica enumerada. Se a operação não for bem-sucedida, a estrutura usará a estrutura WINBIO_ASYNC_RESULT para retornar informações de erro. A estrutura é retornada para o retorno de chamada do aplicativo ou para a fila de mensagens do aplicativo, dependendo do valor definido no parâmetro NotificationMethod da função WinBioAsyncOpenFramework .

  • Se você optar por receber avisos de conclusão usando um retorno de chamada, deverá implementar uma função PWINBIO_ASYNC_COMPLETION_CALLBACK e definir o parâmetro NotificationMethod como WINBIO_ASYNC_NOTIFY_CALLBACK.
  • Se você optar por receber avisos de conclusão usando a fila de mensagens do aplicativo, deverá definir o parâmetro NotificationMethod como WINBIO_ASYNC_NOTIFY_MESSAGE. A estrutura retorna um ponteiro WINBIO_ASYNC_RESULT para o campo LPARAM da mensagem da janela.
A matriz de esquemas é retornada em uma estrutura EnumBiometricUnits aninhada dentro da estrutura WINBIO_ASYNC_RESULT . Você deve chamar WinBioFree para liberar a estrutura WINBIO_ASYNC_RESULT depois de terminar de usá-la.

Chamar WinBioAsyncEnumBiometricUnits faz com que uma única notificação seja enviada ao aplicativo cliente.

Requisitos

   
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbio.h (inclua Winbio.h)
Biblioteca Winbio.lib
DLL Winbio.dll

Confira também

WinBioAsyncOpenFramework