Función WinBioAcquireFocus (winbio.h)

  • Artículo

Adquiere el foco de la ventana.

Sintaxis

HRESULT WinBioAcquireFocus();

Valor devuelto

Si la función se ejecuta correctamente, devuelve S_OK. Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código devuelto Descripción
E_ACCESSDENIED
 El proceso de llamada debe ejecutarse en la cuenta del sistema local.

Comentarios

Windows Biometric Framework usa el foco de ventana para arbitrar entre varias sesiones conectadas al grupo de sistemas.

La manera en que adquiere el foco depende del tipo de aplicación que escriba. Por ejemplo, si va a crear una aplicación de GUI, puede implementar un controlador de mensajes que capture un WM_ACTIVATE, WM_SETFOCUS u otro mensaje adecuado. Si está escribiendo una aplicación CUI, llame a GetConsoleWindow para recuperar un identificador a la ventana de la consola y pasarlo a la función SetForegroundWindow para forzar la ventana de la consola en primer plano y asignarle el foco. Si la aplicación se ejecuta en un proceso desasociado o es un servicio de Windows y no tiene ninguna ventana, use WinBioAcquireFocus y WinBioReleaseFocus para controlar manualmente el foco.

En la lista siguiente se resumen los puntos principales que se deben tener en cuenta antes de llamar a esta función.

  • El proceso de llamada debe ejecutarse en la cuenta del sistema local.
  • Un proceso que muestra directamente una interfaz de usuario no debe llamar a esta función. Consulte la explicación anterior para determinar cómo adquirir el foco para las aplicaciones de GUI y CUI.
  • Solo un servicio o un proceso desasociado que no muestra directamente una interfaz de usuario durante las llamadas a API biométricas debe llamar a esta función.
  • Si la función se ejecuta correctamente, debe llamar a WinBioReleaseFocus para liberar el foco.
Si no adquiere el foco al llamar a las siguientes funciones, se comportarán de maneras inesperadas:

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbio.h (incluya Winbio.h)
Library Winbio.lib
Archivo DLL Winbio.dll

Consulte también

Funciones de aplicación cliente

WinBioEnrollBegin