WinBioMonitorPresence-Funktion (winbio.h)

Artikel
08/27/2023

Aktiviert den Mechanismus zur Gesichtserkennung oder Irisüberwachung für die angegebene biometrische Einheit. Ab Windows 10, Build 1607, ist diese Funktion für die Verwendung mit einem mobilen Image verfügbar.

Syntax

HRESULT WinBioMonitorPresence(
  [in] WINBIO_SESSION_HANDLE SessionHandle,
  [in] WINBIO_UNIT_ID        UnitId
);

Parameter

[in] SessionHandle

Ein asynchrones Handle für die biometrische Sitzung, die Sie durch Aufrufen der WinBioAsyncOpenSession-Funktion erhalten haben, wobei der PoolType-Parameter auf WINBIO_POOL_SYSTEM festgelegt ist.

[in] UnitId

Der Bezeichner der biometrischen Einheit, für die Sie den Mechanismus zur Gesichtserkennung oder Irisüberwachung aktivieren möchten.

Rückgabewert

Wenn die Funktionsparameter akzeptabel sind, wird S_OK zurückgegeben. Wenn die Funktionsparameter nicht akzeptabel sind, wird ein HRESULT-Wert zurückgegeben, 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_HANDLE	Das Sitzungshandle ist ungültig.
E_INVALIDARG	Der UnitId-Parameter darf nicht gleich 0 sein.
WINBIO_E_INCORRECT_SESSION_TYPE	Das Sitzungshandle entspricht nicht einer asynchronen biometrischen Sitzung.

Der tatsächliche Erfolg oder Fehler des Vorgangs selbst wird an die Benachrichtigungsfunktion in einer WINBIO_ASYNC_RESULT-Struktur zurückgegeben.

Hinweise

Eine einzige biometrische Sitzung kann zu einem beliebigen Zeitpunkt nur über einen aktiven Anwesenheitsmonitor verfügen.

Nachdem Sie WinBioMonitorPresence erfolgreich aufgerufen haben, empfängt Ihre Benachrichtigungsfunktion Benachrichtigungen in Form einer WINBIO_ASYNC_RESULT-Struktur mit einem Vorgangsmember , der WINBIO_OPERATION_MONITOR_PRESENCE entspricht. Anschließend sollten Sie das Parameters.MonitorPresence-Element der WINBIO_ASYNC_RESULT-Struktur auf weitere Informationen untersuchen.

Um den Empfang von Benachrichtigungen zu beenden, rufen Sie winBioCancel oder WinBioCloseSession mit dem ursprünglichen asynchronen Handle-Wert auf.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 10 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbio.h
Bibliothek	Winbio.lib
DLL	Winbio.dll

Weitere Informationen

WINBIO_ASYNC_RESULT

WinBioAsyncOpenSession

WinBioCancel

WinBioCloseSession

Share via