Função WinBioAsyncMonitorFrameworkChanges (winbio.h)

  • Artigo

Inicia um monitor assíncrono de alterações na estrutura biométrica. Atualmente, as únicas alterações monitoradas com suporte ocorrem quando uma unidade biométrica é anexada ou desanexada do computador.

Sintaxe

HRESULT WinBioAsyncMonitorFrameworkChanges(
  [in] WINBIO_FRAMEWORK_HANDLE      FrameworkHandle,
  [in] WINBIO_FRAMEWORK_CHANGE_TYPE ChangeTypes
);

Parâmetros

[in] FrameworkHandle

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

[in] ChangeTypes

Uma máscara de bits do tipo WINBIO_FRAMEWORK_CHANGE_TYPE sinalizadores que indica os tipos de eventos que devem gerar notificações assíncronas. Começando com Windows 8, o seguinte sinalizador está disponível:

Valor Significado
WINBIO_FRAMEWORK_CHANGE_UNIT
 Uma unidade biométrica foi anexada ou desanexada do computador.

Retornar valor

A função retorna um HRESULT que indica êxito ou falha. Observe que êxito indica apenas que os argumentos de 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 de WINBIO_ASYNC_RESULT usando o método de notificação especificado em 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 ChangeTypes contém um ou mais bits de tipo inválidos. Atualmente, o único valor disponível é WINBIO_FRAMEWORK_CHANGE_UNIT.
WINBIO_E_INCORRECT_SESSION_TYPE
 O argumento FrameworkHandle deve representar uma sessão de estrutura assíncrona.

Comentários

Depois de iniciado, esse monitor continuará gerando eventos até que o aplicativo cliente chame WinBioCancel ou WinBioCloseFramework. A criação de um monitor para eventos WINBIO_FRAMEWORK_CHANGE_UNIT gerará dois tipos de notificações assíncronas:

Valor Significado
WINBIO_OPERATION_UNIT_ARRIVAL Uma unidade biométrica está anexada.
WINBIO_OPERATION_UNIT_REMOVAL Uma unidade biométrica é desanexada.
 

A função WinBioAsyncMonitorFrameworkChanges 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 uma unidade biométrica estiver anexada ou desanexada do computador, a estrutura definirá o membro Operation da estrutura. Se um problema for encontrado durante a operação, 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.
As notificações são retornadas em uma estrutura EnumServiceProviders aninhada dentro da estrutura WINBIO_ASYNC_RESULT . Você deve chamar WinBioFree para liberar a estrutura WINBIO_ASYNC_RESULT depois de terminar de usá-la.

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