Freigeben über


WinBioMonitorPresence-Funktion (winbio.h)

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