Função WinBioAsyncEnumDatabases (winbio.h)

  • Artigo

Enumera de forma assíncrona todos os bancos de dados registrados que correspondem a um tipo especificado. Para obter uma versão síncrona dessa função, consulte WinBioEnumDatabases.

Sintaxe

HRESULT WinBioAsyncEnumDatabases(
  [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 banco de dados biométricos a serem enumerados. Somente WINBIO_TYPE_FINGERPRINT tem suporte no momento.

Retornar valor

A função retorna um HRESULT que indica êxito ou falha. Observe que o sucesso indica apenas que os argumentos da função 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_INCORRECT_SESSION_TYPE
 O argumento FrameworkHandle deve representar uma sessão de estrutura assíncrona.

Comentários

A função WinBioAsyncEnumDatabases 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 banco de dados enumerado. 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 EnumDatabases 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 WinBioAsyncEnumDatabases faz com que uma única notificação seja enviada ao aplicativo cliente.

Requisitos

Requisito Valor
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