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.
Listet asynchron alle angefügten biometrischen Einheiten auf, die dem Eingabefaktortyp entsprechen. Eine synchrone Version dieser Funktion finden Sie unter WinBioEnumBiometricUnits. Ab Windows 10, Build 1607, ist diese Funktion für die Verwendung mit einem mobilen Image verfügbar.
Syntax
HRESULT WinBioAsyncEnumBiometricUnits(
[in] WINBIO_FRAMEWORK_HANDLE FrameworkHandle,
[in] WINBIO_BIOMETRIC_TYPE Factor
);
Die Parameter
[in] FrameworkHandle
Behandeln Sie die Frameworksitzung, die durch Aufrufen von WinBioAsyncOpenFramework geöffnet wird.
[in] Factor
Eine Bitmaske von WINBIO_BIOMETRIC_TYPE Flags, die die biometrischen Einheitentypen angibt, die aufgezählt werden sollen. Derzeit wird nur WINBIO_TYPE_FINGERPRINT unterstützt.
Rückgabewert
Die Funktion gibt ein HRESULT zurück, das den Erfolg oder Fehler angibt. Beachten Sie, dass der Erfolg nur angibt, dass die Argumente gültig waren. Fehler, die während der Ausführung des Vorgangs aufgetreten sind, werden asynchron mithilfe der im Aufruf von WinBioAsyncOpenFramework angegebenen Benachrichtigungsmethode an eine WINBIO_ASYNC_RESULT Struktur zurückgegeben.
| Rückgabecode | Description |
|---|---|
|
Sie müssen das FrameworkHandle-Argument festlegen. |
|
Die im Parameter Factor enthaltene Bitmaske enthält mindestens ein ungültiges Bit. |
|
Es war nicht genügend Arbeitsspeicher vorhanden, um die Anforderung abzuschließen. |
|
Die aktuelle Administrative Richtlinie verbietet die Verwendung der Windows-Biometrie-Framework-API. |
|
Das FrameworkHandle-Argument muss eine asynchrone Frameworksitzung darstellen. |
|
Der Sitzungshandle wurde zum Schließen markiert. |
Bemerkungen
Die WinBioAsyncEnumBiometricUnits-Funktion verwendet ein Handle für die Frameworksitzung, die durch Aufrufen von WinBioAsyncOpenFramework geöffnet wird. Das Framework weist eine WINBIO_ASYNC_RESULT Struktur zu und verwendet es, um Informationen zum Erfolg oder Fehler des Vorgangs zurückzugeben. Wenn der Enumerationsvorgang erfolgreich ist, gibt das Framework ein Array von Schemas zurück, das Informationen zu jeder aufgezählten biometrischen Einheit enthält. Wenn der Vorgang nicht erfolgreich ist, verwendet das Framework die WINBIO_ASYNC_RESULT Struktur, um Fehlerinformationen zurückzugeben. Die Struktur wird an den Anwendungsrückruf oder an die Anwendungsnachrichtenwarteschlange zurückgegeben, abhängig vom Wert, den Sie im Parameter NotificationMethod der WinBioAsyncOpenFramework-Funktion festgelegt haben.
- Wenn Sie sich für den Empfang von Abschlussbenachrichtigungen mithilfe eines Rückrufs entscheiden, müssen Sie eine PWINBIO_ASYNC_COMPLETION_CALLBACK-Funktion implementieren und den Parameter NotificationMethod auf WINBIO_ASYNC_NOTIFY_CALLBACK festlegen.
- Wenn Sie mithilfe der Anwendungsnachrichtenwarteschlange Abschlussbenachrichtigungen empfangen möchten, müssen Sie den Parameter NotificationMethod auf WINBIO_ASYNC_NOTIFY_MESSAGE festlegen. Das Framework gibt einen WINBIO_ASYNC_RESULT Zeiger auf das LPARAM-Feld der Fenstermeldung zurück.
Durch Aufrufen von WinBioAsyncEnumBiometricUnits wird eine einzelne Benachrichtigung an die Clientanwendung gesendet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client | Windows 8 [nur Desktop-Apps] |
| Mindestanforderungen für unterstützte Server | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Fenster |
| Header | winbio.h (enthalten Winbio.h) |
| Library | Winbio.lib |
| DLL | Winbio.dll |