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 |
|---|---|
|
Das Sitzungshandle ist ungültig. |
|
Der UnitId-Parameter darf nicht gleich 0 sein. |
|
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 |