WinBioAsyncMonitorFrameworkChanges-Funktion (winbio.h)
Startet einen asynchronen Monitor der Änderungen am biometrischen Framework. Derzeit treten die einzigen überwachten Änderungen auf, die unterstützt werden, wenn eine biometrische Einheit an den Computer angefügt oder davon getrennt wird.
Syntax
HRESULT WinBioAsyncMonitorFrameworkChanges(
[in] WINBIO_FRAMEWORK_HANDLE FrameworkHandle,
[in] WINBIO_FRAMEWORK_CHANGE_TYPE ChangeTypes
);
Parameter
[in] FrameworkHandle
Handle für die Frameworksitzung, die durch Aufrufen von WinBioAsyncOpenFramework geöffnet wird.
[in] ChangeTypes
Eine Bitmaske vom Typ WINBIO_FRAMEWORK_CHANGE_TYPE Flags, die die Ereignistypen angibt, die asynchrone Benachrichtigungen generieren sollen. Ab Windows 8 ist das folgende Flag verfügbar:
| Wert | Bedeutung |
|---|---|
|
Eine biometrische Einheit wurde an den Computer angefügt oder davon getrennt. |
Rückgabewert
Die Funktion gibt ein HRESULT zurück , das den Erfolg oder Fehler angibt. Beachten Sie, dass erfolg nur angibt, dass die Funktionsargumente gültig waren. Fehler, die während der Ausführung des Vorgangs auftreten, werden mithilfe der in WinBioAsyncOpenFramework angegebenen Benachrichtigungsmethode asynchron an eine WINBIO_ASYNC_RESULT-Struktur zurückgegeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Sie müssen das Argument FrameworkHandle festlegen. |
|
Die im ChangeTypes-Parameter enthaltene Bitmaske enthält mindestens ein ungültiges Typbit. Derzeit ist der einzige verfügbare Wert WINBIO_FRAMEWORK_CHANGE_UNIT. |
|
Das Argument FrameworkHandle muss eine asynchrone Frameworksitzung darstellen. |
Hinweise
Nach dem Start generiert dieser Monitor weiterhin Ereignisse, bis die Clientanwendung WinBioCancel oder WinBioCloseFramework aufruft. Beim Erstellen eines Monitors für WINBIO_FRAMEWORK_CHANGE_UNIT Ereignisse werden zwei Arten von asynchronen Benachrichtigungen generiert:
| Wert | Bedeutung |
|---|---|
| WINBIO_OPERATION_UNIT_ARRIVAL | Eine biometrische Einheit ist angefügt. |
| WINBIO_OPERATION_UNIT_REMOVAL | Eine biometrische Einheit wird getrennt. |
Die WinBioAsyncMonitorFrameworkChanges-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 eine biometrische Einheit an den Computer angefügt oder von diesem getrennt wird, legt das Framework den Vorgangsmember der Struktur fest. Wenn während des Vorgangs ein Problem auftritt, 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.
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 (winbio.h einschließen) |
| Bibliothek | Winbio.lib |
| DLL | Winbio.dll |