WinBioAsyncEnumBiometricUnits-Funktion (winbio.h)

Artikel
08/27/2023

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
);

Parameter

[in] FrameworkHandle

Handle für die Frameworksitzung, die durch Aufrufen von WinBioAsyncOpenFramework geöffnet wird.

[in] Factor

Eine Bitmaske mit WINBIO_BIOMETRIC_TYPE Flags, die die zu enumerierten biometrischen Einheitentypen angibt. 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 erfolg nur angibt, dass die Argumente gültig waren. Fehler, die während der Ausführung des Vorgangs auftreten, werden asynchron an eine WINBIO_ASYNC_RESULT-Struktur zurückgegeben, indem die im Aufruf von WinBioAsyncOpenFramework angegebene Benachrichtigungsmethode verwendet wird.

Rückgabecode	Beschreibung
E_HANDLE	Sie müssen das Argument FrameworkHandle festlegen.
E_INVALIDARG	Die im Factor-Parameter enthaltene Bitmaske enthält ein oder mehrere ungültige Typbits.
E_OUTOFMEMORY	Es war nicht genügend Arbeitsspeicher vorhanden, um die Anforderung abzuschließen.
WINBIO_E_DISABLED	Die aktuelle Verwaltungsrichtlinie verbietet die Verwendung der Windows Biometric Framework-API.
WINBIO_E_INCORRECT_SESSION_TYPE	Das Argument FrameworkHandle muss eine asynchrone Frameworksitzung darstellen.
WINBIO_E_SESSION_HANDLE_CLOSED	Das Sitzungshandle wurde zum Schließen markiert.

Hinweise

Die WinBioAsyncEnumBiometricUnits-Funktion verwendet ein Handle für die Frameworksitzung, die durch Aufrufen von WinBioAsyncOpenFramework geöffnet wird. Das Framework ordnet eine WINBIO_ASYNC_RESULT-Struktur zu und verwendet sie, um Informationen über erfolgreiche oder fehlgeschlagene Vorgänge zurückzugeben. Wenn der Enumerationsvorgang erfolgreich ist, gibt das Framework ein Array von Schemas zurück, die Informationen zu jeder aufgezählten biometrischen Einheit enthalten. 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 die Anwendungsnachrichtenwarteschlange zurückgegeben, je nachdem, welche Werte Sie im NotificationMethod-Parameter der WinBioAsyncOpenFramework-Funktion festgelegt haben.

Wenn Sie Vervollständigungsbenachrichtigungen mithilfe eines Rückrufs erhalten möchten, müssen Sie eine PWINBIO_ASYNC_COMPLETION_CALLBACK-Funktion implementieren und den NotificationMethod-Parameter auf WINBIO_ASYNC_NOTIFY_CALLBACK festlegen.
Wenn Sie Vervollständigungsbenachrichtigungen mithilfe der Anwendungsnachrichtenwarteschlange empfangen möchten, müssen Sie den NotificationMethod-Parameter auf WINBIO_ASYNC_NOTIFY_MESSAGE festlegen. Das Framework gibt einen WINBIO_ASYNC_RESULT Zeiger auf das LPARAM-Feld der Fenstermeldung zurück.

Das Array von Schemas wird in einer EnumBiometricUnits-Struktur zurückgegeben, die in der WINBIO_ASYNC_RESULT-Struktur geschachtelt ist. Sie müssen WinBioFree aufrufen, um die WINBIO_ASYNC_RESULT-Struktur freizugeben, nachdem Sie sie verwendet haben.

Wenn WinBioAsyncEnumBiometricUnits aufgerufen wird, wird eine einzelne Benachrichtigung an die Clientanwendung gesendet.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbio.h (winbio.h einschließen)
Bibliothek	Winbio.lib
DLL	Winbio.dll

Weitere Informationen

WinBioAsyncOpenFramework

Freigeben über