WinBioEnrollSelect-Funktion (winbio.h)

Artikel
08/27/2023

Gibt die Person an, die Sie registrieren möchten, wenn Daten, die mehrere Personen darstellen, im Beispielpuffer vorhanden sind. Ab Windows 10 Build 1607 ist diese Funktion für die Verwendung mit einem mobilen Image verfügbar.

Syntax

HRESULT WinBioEnrollSelect(
  [in] WINBIO_SESSION_HANDLE SessionHandle,
  [in] ULONGLONG             SelectorValue
);

Parameter

[in] SessionHandle

Ein WINBIO_SESSION_HANDLE Wert, der eine offene biometrische Sitzung identifiziert. Öffnen Sie ein synchrones Sitzungshandle, indem Sie WinBioOpenSession aufrufen. Öffnen Sie ein asynchrones Sitzungshandle, indem Sie WinBioAsyncOpenSession aufrufen.

Verwenden Sie für die Registrierung in der Gesichtserkennung WinBioAsyncOpenSession , wobei der Parameter PoolType auf WINBIO_POOL_SYSTEM festgelegt ist, um das Handle abzurufen.

[in] SelectorValue

Ein -Wert, der die Person identifiziert, die Sie für die Registrierung auswählen möchten.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Wenn die Funktion fehlschlägt, 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 SelectorValue-Parameter kann nicht gleich 0 (null) sein.
WINBIO_E_INCORRECT_SESSION_TYPE	Das Sitzungshandle entspricht keiner biometrischen Sitzung.

Hinweise

Für die Registrierung in der Gesichtserkennung können Sie den richtigen Selektorwert auf zwei Arten finden:

Der Wert des Id-Elements einer der zuvor gesendeten WINBIO_PRESENCE Strukturen.
Die von den NUI-Gesichtsverfolgungs-APIs erzeugten Daten.

Rufen Sie WinBioEnrollSelect auf, um den Selektorwert festzulegen, nachdem Sie WinBioEnrollBegin aufgerufen haben, um eine Registrierungssequenz zu starten. Der Selektorwert gilt für alle nachfolgenden WinBioEnrollCapture-Aufrufe . Die Auswahleinstellung ist temporär und wird automatisch gelöscht, wenn Sie die Registrierungssequenz durch Aufrufen von WinBioEnrollCommit oder WinBioEnrollDiscard beenden.

Wenn Sie WinBioEnrollSelect für biometrische Faktoren aufrufen, die keine Mehrdeutigkeit erfordern, z. B. Fingerabdrücke, gibt der Rückgabewert für die Funktion den Erfolg an, aber die Funktion ignoriert den Selektorwert.

Wenn Sie WinBioEnrollSelect nicht für einen biometrischen Faktor aufrufen, für den Sie die Funktion aufrufen müssen, schlagen nachfolgende Aufrufe von WinBioEnrollCapture mit dem WINBIO_E_SELECTION_REQUIRED Fehler fehl.

Für Windows 10 sind die Faktoren, die WinBioEnrollSelect aufrufen müssen, Gesichtszüge und Iris.

Sie können WinBioEnrollSelect aufrufen, indem Sie entweder ein synchrones oder ein asynchrones Sitzungshandle verwenden. Wie bei anderen Aufrufen von Windows Biometric Framework-API-Funktionen gibt der Rückgabewert nur an, dass die Funktionsparameter akzeptabel waren, wenn Sie WinBioEnrollSelect mit einem asynchronen Sitzungshandle aufrufen. Der tatsächliche Erfolg oder Fehler des Vorgangs selbst wird in einer WINBIO_ASYNC_RESULT-Struktur an Ihre Benachrichtigungsroutine zurückgegeben.

Anforderungen

Anforderung	Wert
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