WINBIO_EVENT Struktur
Die WINBIO_EVENT-Struktur enthält status Informationen, die an die Rückrufroutine gesendet werden, wenn eine Ereignisbenachrichtigung ausgelöst wird.
Syntax
typedef struct _WINBIO_EVENT {
WINBIO_EVENT_TYPE Type;
union {
struct {
WINBIO_UNIT_ID UnitId;
WINBIO_REJECT_DETAIL RejectDetail;
} Unclaimed;
struct {
WINBIO_UNIT_ID UnitId;
WINBIO_IDENTITY Identity;
WINBIO_BIOMETRIC_SUBTYPE SubFactor;
WINBIO_REJECT_DETAIL RejectDetail;
} UnclaimedIdentify;
struct {
HRESULT ErrorCode;
} Error;
} Parameters;
} WINBIO_EVENT, *PWINBIO_EVENT;
Member
-
Typ
-
Ein Wert, der den Typ der ausgelösten Dienstanbieterereignisbenachrichtigung angibt. Der einzige Anbieter, der derzeit unterstützt wird, ist der Fingerabdrucksensor. Dieser Sensor unterstützt die folgenden Flags.
-
WINBIO_EVENT_FP_UNCLAIMED (Der Sensor hat einen Finger wischen erkannt, der nicht von der Anwendung oder dem Fenster angefordert wurde, das derzeit den Fokus hat. Das Windows Biometric Framework ruft Ihre Rückruffunktion auf, um anzugeben, dass ein Finger wischen stattgefunden hat, aber nicht versucht, den Fingerabdruck zu identifizieren.)
-
WINBIO_EVENT_FP_UNCLAIMED_IDENTIFY (Der Sensor hat einen Finger wischen erkannt, der nicht von der Anwendung oder dem Fenster angefordert wurde, das derzeit den Fokus hat. Das Biometrische Windows-Framework versucht, den Fingerabdruck zu identifizieren und übergibt das Ergebnis dieses Prozesses an Ihre Rückruffunktion.)
-
-
Parameter
-
-
Herrenlosen
-
Für die biometrische Stichprobenerfassung zurückgegebene Struktur.
-
UnitId
-
Die biometrische Einheit, die die Stichprobe generiert hat.
-
RejectDetail
-
Ein ULONG-Wert , der zusätzliche Informationen zum Fehler bei der Erfassung einer biometrischen Stichprobe enthält. Wenn eine Erfassung erfolgreich war, wird dieser Parameter auf 0 festgelegt. Die folgenden Werte werden für die Fingerabdruckerfassung definiert:
- WINBIO_FP_TOO_HIGH
- WINBIO_FP_TOO_LOW
- WINBIO_FP_TOO_LEFT
- WINBIO_FP_TOO_RIGHT
- WINBIO_FP_TOO_FAST
- WINBIO_FP_TOO_SLOW
- WINBIO_FP_POOR_QUALITY
- WINBIO_FP_TOO_SKEWED
- WINBIO_FP_TOO_SHORT
- WINBIO_FP_MERGE_FAILURE
-
-
UnclaimedIdentify
-
Für biometrische Erfassung und Identifizierung zurückgegebene Struktur. Die Identifizierung bestimmt, ob eine Stichprobe einer vorhandenen biometrischen Vorlage zugeordnet werden kann.
-
UnitId
-
Die biometrische Einheit, die die Stichprobe generiert hat.
-
Identität
-
Eine WINBIO_IDENTITY Struktur, die die GUID oder SID des Benutzers enthält, der die biometrische Stichprobe bereitstellt.
-
SubFactor
-
Ein WINBIO_BIOMETRIC_SUBTYPE Wert, der den Teilfaktor angibt, der einer biometrischen Stichprobe zugeordnet ist. Das Windows Biometric Framework (WBF) unterstützt derzeit nur die Fingerabdruckerfassung und verwendet die folgenden Konstanten, um Untertypinformationen darzustellen.
- WINBIO_ANSI_381_POS_UNKNOWN
- WINBIO_ANSI_381_POS_RH_THUMB
- WINBIO_ANSI_381_POS_RH_INDEX_FINGER
- WINBIO_ANSI_381_POS_RH_MIDDLE_FINGER
- WINBIO_ANSI_381_POS_RH_RING_FINGER
- WINBIO_ANSI_381_POS_RH_LITTLE_FINGER
- WINBIO_ANSI_381_POS_LH_THUMB
- WINBIO_ANSI_381_POS_LH_INDEX_FINGER
- WINBIO_ANSI_381_POS_LH_MIDDLE_FINGER
- WINBIO_ANSI_381_POS_LH_RING_FINGER
- WINBIO_ANSI_381_POS_LH_LITTLE_FINGER
- WINBIO_ANSI_381_POS_RH_FOUR_FINGERS
- WINBIO_ANSI_381_POS_LH_FOUR_FINGERS
- WINBIO_ANSI_381_POS_TWO_THUMBS
Wichtig
Versuchen Sie nicht, den für den SubFactor-Wert angegebenen Wert zu überprüfen. Der Windows-Biometrische Dienst überprüft den angegebenen Wert, bevor er an Ihre Implementierung übergeben wird. Wenn der Wert WINBIO_SUBTYPE_NO_INFORMATION oder WINBIO_SUBTYPE_ANY ist, überprüfen Sie gegebenenfalls.
-
RejectDetail
-
Ein ULONG-Wert , der zusätzliche Informationen zum Fehler bei der Erfassung einer biometrischen Stichprobe enthält. Wenn die Erfassung erfolgreich war, wird dieser Parameter auf 0 festgelegt. Die folgenden Werte werden für die Fingerabdruckerfassung definiert:
- WINBIO_FP_TOO_HIGH
- WINBIO_FP_TOO_LOW
- WINBIO_FP_TOO_LEFT
- WINBIO_FP_TOO_RIGHT
- WINBIO_FP_TOO_FAST
- WINBIO_FP_TOO_SLOW
- WINBIO_FP_POOR_QUALITY
- WINBIO_FP_TOO_SKEWED
- WINBIO_FP_TOO_SHORT
- WINBIO_FP_MERGE_FAILURE
-
-
Fehler
-
Struktur, die den Erfolg oder Fehler des überwachten Vorgangs identifiziert.
-
ErrorCode
-
HRESULT-Wert , der S_OK oder einen Fehlercode enthält, der aus Berechnungen des Windows Biometric Frameworks resultiert.
-
-
Bemerkungen
Rufen Sie die WinBioRegisterEventMonitor-Funktion auf, um eine Rückrufroutine für den Empfang von Ereignisbenachrichtigungen vom Windows Biometric Framework zu registrieren. Der Rückruf ist eine benutzerdefinierte Funktion, die Sie für Ihre Anwendung definieren müssen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 R2 [nur Desktop-Apps] |
| Header |
|