Função WinBioAcquireFocus (winbio.h)

  • Artigo

Adquire o foco da janela.

Sintaxe

HRESULT WinBioAcquireFocus();

Retornar valor

Se a função for bem-sucedida, ela retornará S_OK. Se a função falhar, ela 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_ACCESSDENIED
 O processo de chamada deve estar em execução na conta Sistema Local.

Comentários

A Estrutura Biométrica do Windows usa o foco da janela para arbitrar entre várias sessões conectadas ao pool do sistema.

A maneira como você adquire foco depende do tipo de aplicativo que você está escrevendo. Por exemplo, se você estiver criando um aplicativo de GUI, poderá implementar um manipulador de mensagens que captura um WM_ACTIVATE, WM_SETFOCUS ou outra mensagem apropriada. Se você estiver escrevendo um aplicativo CUI, chame GetConsoleWindow para recuperar um identificador para a janela do console e passe esse identificador para a função SetForegroundWindow para forçar a janela do console para o primeiro plano e atribuí-lo ao foco. Se o aplicativo estiver em execução em um processo desanexado ou for um serviço Windows e não tiver janela, use WinBioAcquireFocus e WinBioReleaseFocus para controlar manualmente o foco.

A lista a seguir resume os principais pontos a serem considerados antes de chamar essa função.

  • O processo de chamada deve estar em execução na conta Sistema Local.
  • Um processo que exibe diretamente uma interface do usuário não deve chamar essa função. Consulte a discussão anterior para determinar como adquirir o foco para aplicativos de GUI e CUI.
  • Somente um serviço ou um processo desanexado que não exibe diretamente uma interface do usuário durante chamadas biométricas da API deve chamar essa função.
  • Se a função for bem-sucedida, você deverá chamar WinBioReleaseFocus para liberar o foco.
Se você não adquirir foco ao chamar as seguintes funções, elas se comportarão de maneiras inesperadas:

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [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

Funções de aplicativo cliente

WinBioEnrollBegin