Partager via

Fonction WinBioReleaseFocus (winbio.h)

  • Article

Libère le focus de la fenêtre.

Syntaxe

HRESULT WinBioReleaseFocus();

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 s’exécuter sous le compte Système local.

Remarques

Windows Biometric Framework utilise le focus de fenêtre pour arbitrer entre plusieurs sessions connectées au pool système.

La façon dont vous acquérez 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 passer ce handle à la fonction SetForegroundWindow pour forcer la fenêtre de console au premier plan et lui attribuer le focus. Si votre application s’exécute dans un processus détaché ou est un service Windows et n’a pas de 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 WinBioAcquireFocus et WinBioReleaseFocus.

  • Le processus appelant doit s’exécuter sous le compte Système local.
  • Un processus qui affiche directement une interface utilisateur ne doit pas appeler WinBioAcquireFocus. 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 une interface utilisateur lors des appels d’API biométriques doit appeler cette fonction.
Si vous n’obtenez pas le focus lors de l’appel des fonctions suivantes, celles-ci 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