Partager via

Fonction WinBioAcquireFocus (winbio.h)

  • Article

Acquiert le focus de fenêtre.

Syntaxe

HRESULT WinBioAcquireFocus();

Valeur de retour

Si la fonction réussit, elle retourne S_OK. Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Les valeurs possibles sont notamment celles figurant dans le tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Code de retour Description
E_ACCESSDENIED
 Le processus appelant doit être en cours d’exécution sous le compte Système local.

Remarques

L’infrastructure biométrique Windows utilise le focus de fenêtre pour arbitrer entre plusieurs sessions connectées au pool système.

La façon dont vous obtenez le focus dépend du type d’application que vous écrivez. Par exemple, si vous créez une application GUI, vous pouvez implémenter un gestionnaire de messages qui capture un WM_ACTIVATE, un WM_SETFOCUS ou un autre message approprié. Si vous écrivez une application CUI, appelez GetConsoleWindow pour récupérer un handle dans la fenêtre de console et passez ce handle à la fonction SetForegroundWindow pour forcer la fenêtre de console au premier plan et lui affecter le focus. Si votre application s’exécute dans un processus détaché ou s’il s’agit d’un service Windows sans fenêtre, utilisez WinBioAcquireFocus et WinBioReleaseFocus pour contrôler manuellement le focus.

La liste suivante récapitule les principaux points à prendre en compte avant d’appeler cette fonction.

  • Le processus appelant doit être en cours d’exécution sous le compte Système local.
  • Un processus qui affiche directement une interface utilisateur ne doit pas appeler cette fonction. Consultez la discussion précédente pour déterminer comment acquérir le focus pour les applications gui et CUI.
  • Seul un service ou un processus détaché qui n’affiche pas directement d’interface utilisateur pendant les appels d’API biométriques doit appeler cette fonction.
  • Si la fonction réussit, vous devez appeler WinBioReleaseFocus pour libérer le focus.
Si vous n’obtenez pas le focus lors de l’appel des fonctions suivantes, elles se comportent de manière inattendue :

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winbio.h (inclure Winbio.h)
Bibliothèque Winbio.lib
DLL Winbio.dll

Voir aussi

Fonctions d’application cliente

WinBioEnrollBegin