Freigeben über


WinBioAsyncEnumServiceProviders-Funktion (winbio.h)

Gibt asynchron Informationen zu installierten biometrischen Dienstanbietern zurück. Ab Windows 10 Build 1607 ist diese Funktion für die Verwendung mit einem mobilen Image verfügbar. Eine synchrone Version dieser Funktion finden Sie unter WinBioEnumServiceProviders.

Syntax

HRESULT WinBioAsyncEnumServiceProviders(
  [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 enumerierenden biometrischen Dienstanbietertypen angibt. Für Windows 8 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 success nur angibt, 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 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_INCORRECT_SESSION_TYPE
Das Argument FrameworkHandle muss eine asynchrone Frameworksitzung darstellen.

Hinweise

Die WinBioAsyncEnumServiceProviders-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 jedem enumerierten Anbieter 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 EnumServiceProviders-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 WinBioAsyncEnumServiceProviders 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