Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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
);
Die Parameter
[in] SessionHandle
Ein WINBIO_SESSION_HANDLE Wert, der eine geöffnete 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 PoolType-Parameter 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ögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt. Eine Liste allgemeiner Fehlercodes finden Sie unter "Allgemeine HRESULT-Werte".
| Rückgabecode | Description |
|---|---|
|
Das Sitzungshandle ist ungültig. |
|
Der Parameter SelectorValue darf nicht gleich Null sein. |
|
Das Sitzungshandle entspricht keiner biometrischen Sitzung. |
Bemerkungen
Für die Registrierung bei der Gesichtserkennung finden Sie den richtigen Selektorwert auf zwei Arten:
- Der Wert des ID-Elements eines der zuvor gesendeten WINBIO_PRESENCE Strukturen.
- Die von den NUI-Gesichtsverfolgungs-APIs erzeugten Daten.
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, der erfordert, dass 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 erfordern, winBioEnrollSelect aufzurufen, Gesichtsfunktionen und Iris.
Sie können WinBioEnrollSelect aufrufen, indem Sie entweder ein synchrones oder 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 |
|---|---|
| Mindestens unterstützter Client | Windows 10 [nur Desktop-Apps] |
| Mindestanforderungen für unterstützte Server | Windows Server 2016 [nur Desktop-Apps] |
| Zielplattform | Fenster |
| Header | winbio.h |
| Library | Winbio.lib |
| DLL | Winbio.dll |