WinBioAsyncEnumDatabases-Funktion (winbio.h)

Artikel
03/13/2024

Listet asynchron alle registrierten Datenbanken auf, die einem angegebenen Typ entsprechen. Eine synchrone Version dieser Funktion finden Sie unter WinBioEnumDatabases.

Syntax

HRESULT WinBioAsyncEnumDatabases(
  [in] WINBIO_FRAMEWORK_HANDLE FrameworkHandle,
  [in] WINBIO_BIOMETRIC_TYPE   Factor
);

Parameter

[in] FrameworkHandle

Handle mit der Frameworksitzung, die durch Aufrufen von WinBioAsyncOpenFramework geöffnet wird.

[in] Factor

Eine Bitmaske von WINBIO_BIOMETRIC_TYPE Flags, die die zu aufzählenden biometrischen Datenbanktypen angibt. Nur WINBIO_TYPE_FINGERPRINT wird derzeit unterstützt.

Rückgabewert

Die Funktion gibt ein HRESULT zurück, das den Erfolg oder Fehler angibt. Beachten Sie, dass der Erfolg nur darauf hinweist, dass die Argumente der Funktion 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 Benachrichtigungsmethode verwendet wird, die im Aufruf von WinBioAsyncOpenFramework angegeben ist.

Rückgabecode	Beschreibung
E_HANDLE	Sie müssen das FrameworkHandle-Argument festlegen.
E_INVALIDARG	Die im Factor-Parameter enthaltene Bitmaske enthält mindestens ein ungültiges Bit vom Typ.
E_OUTOFMEMORY	Es war nicht genügend Arbeitsspeicher vorhanden, um die Anforderung abzuschließen.
WINBIO_E_INCORRECT_SESSION_TYPE	Das FrameworkHandle-Argument muss eine asynchrone Frameworksitzung darstellen.

Hinweise

Die WinBioAsyncEnumDatabases-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 sie, um Informationen zum Erfolg oder Fehler des Vorgangs zurückzugeben. Wenn der Enumerationsvorgang erfolgreich ist, gibt das Framework ein Array von Schemas zurück, die Informationen zu jeder aufgezählten Datenbank 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 an die Anwendungsnachrichtenwarteschlange zurückgegeben, abhängig vom Wert, den Sie im NotificationMethod-Parameter der WinBioAsyncOpenFramework-Funktion festgelegt haben.

Wenn Sie sich dafür entscheiden, Vervollständigungsbenachrichtigungen mithilfe eines Rückrufs zu erhalten, müssen Sie eine PWINBIO_ASYNC_COMPLETION_CALLBACK-Funktion implementieren und den NotificationMethod-Parameter auf WINBIO_ASYNC_NOTIFY_CALLBACK festlegen.
Wenn Sie sich dafür entscheiden, Vervollständigungsbenachrichtigungen mithilfe der Anwendungsnachrichtenwarteschlange zu erhalten, 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 Fensternachricht zurück.

Das Array von Schemas wird in einer EnumDatabases-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.

Durch das Aufrufen von WinBioAsyncEnumDatabases wird eine einzelne Benachrichtigung an die Clientanwendung gesendet.

Anforderungen

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

Weitere Informationen

WinBioAsyncOpenFramework

Share via