WinBioAcquireFocus-Funktion (winbio.h)

  • Artikel

Ruft den Fensterfokus ab.

Syntax

HRESULT WinBioAcquireFocus();

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie S_OK zurück. Wenn die Funktion fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Rückgabecode Beschreibung
E_ACCESSDENIED
 Der aufrufende Prozess muss unter dem lokalen Systemkonto ausgeführt werden.

Hinweise

Das Windows Biometric Framework verwendet den Fensterfokus, um zwischen mehreren Sitzungen zu schieden, die mit dem Systempool verbunden sind.

Die Art und Weise, wie Sie den Fokus erlangen, hängt von der Art der Anwendung ab, die Sie schreiben. Wenn Sie beispielsweise eine GUI-Anwendung erstellen, können Sie einen Nachrichtenhandler implementieren, der eine WM_ACTIVATE, WM_SETFOCUS oder eine andere geeignete Nachricht erfasst. Wenn Sie eine CUI-Anwendung schreiben, rufen Sie GetConsoleWindow auf, um ein Handle an das Konsolenfenster abzurufen, und übergeben Sie dieses Handle an die SetForegroundWindow-Funktion , um das Konsolenfenster im Vordergrund zu erzwingen und ihm den Fokus zuzuweisen. Wenn Ihre Anwendung in einem getrennten Prozess ausgeführt wird oder ein Windows-Dienst ist und über kein Fenster verfügt, verwenden Sie WinBioAcquireFocus und WinBioReleaseFocus , um den Fokus manuell zu steuern.

In der folgenden Liste sind die wichtigsten Punkte zusammengefasst, die vor dem Aufrufen dieser Funktion zu berücksichtigen sind.

  • Der aufrufende Prozess muss unter dem lokalen Systemkonto ausgeführt werden.
  • Ein Prozess, der direkt eine Benutzeroberfläche anzeigt, sollte diese Funktion nicht aufrufen. In der obigen Diskussion erfahren Sie, wie Sie den Fokus für GUI- und CUI-Anwendungen erlangen.
  • Nur ein Dienst oder ein getrennter Prozess, der während biometrischer API-Aufrufe nicht direkt eine Benutzeroberfläche anzeigt, sollte diese Funktion aufrufen.
  • Wenn die Funktion erfolgreich ist, müssen Sie WinBioReleaseFocus aufrufen, um den Fokus freizugeben.
Wenn Sie beim Aufrufen der folgenden Funktionen den Fokus nicht erhalten, verhalten sie sich unerwartet:

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winbio.h (einschließlich Winbio.h)
Bibliothek Winbio.lib
DLL Winbio.dll

Weitere Informationen

Clientanwendungsfunktionen

WinBioEnrollBegin