Função WinBioReleaseFocus (winbio.h)

  • Artigo

Libera o foco da janela.

Sintaxe

HRESULT WinBioReleaseFocus();

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 o foco depende do tipo de aplicativo que você está escrevendo. Por exemplo, se você estiver criando um aplicativo 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 do 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 WinBioAcquireFocus e WinBioReleaseFocus.

  • 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 WinBioAcquireFocus. Consulte a discussão anterior para determinar como adquirir o foco para aplicativos 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 à API deve chamar essa função.
Se você não adquirir o 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