_Structure d’événement WINBIO
La structure d' _ événement WINBIO contient les informations d’État envoyées à la routine de rappel lorsqu’une notification d’événement est déclenchée.
Syntaxe
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;
Membres
-
Type
-
Valeur qui spécifie le type d’avis d’événement du fournisseur de services déclenché. Le seul fournisseur actuellement pris en charge est le capteur d’empreintes digitales. Ce capteur prend en charge les indicateurs suivants.
-
WINBIO _ ÉVÉNEMENT _ FP non _ réclamé (le capteur a détecté un glissement Finger qui n’a pas été demandé par l’application ou par la fenêtre qui a actuellement le focus. le Windows Biometric Framework appelle la fonction de rappel pour indiquer qu’un glissement finger s’est produit, mais n’essaie pas d’identifier l’empreinte digitale.
-
WINBIO _ _ _ _ Identification non revendiquée du FP d’événement (le capteur a détecté un glissement Finger qui n’a pas été demandé par l’application ou par la fenêtre qui a actuellement le focus. le Windows Biometric Framework tente d’identifier l’empreinte digitale et transmet le résultat de ce processus à votre fonction de rappel.)
-
-
Paramètres
-
-
Revendication
-
Structure retournée pour l’exemple de capture biométrique.
-
UnitId
-
Unité biométrique qui a généré l’exemple.
-
RejectDetail
-
Valeur ULong qui contient des informations supplémentaires sur l’échec de la capture d’un échantillon biométrique. Si une capture a réussi, ce paramètre a la valeur zéro. Les valeurs suivantes sont définies pour la capture d’empreinte digitale :
- WINBIO _ FP _ trop _ élevé
- WINBIO _ FP _ trop _ faible
- WINBIO _ FP _ trop à _ gauche
- WINBIO _ FP _ trop à _ droite
- WINBIO _ FP _ trop _ Fast
- WINBIO _ FP _ trop _ lent
- _ _ qualité médiocre de WINBIO FP _
- WINBIO _ FP _ trop _ incliné
- WINBIO _ FP _ trop _ petit
- échec de la _ fusion WINBIO FP _ _
-
-
UnclaimedIdentify
-
Structure retournée pour la capture et l’identification biométriques. L’identification détermine si un exemple peut être associé à un modèle biométrique existant.
-
UnitId
-
Unité biométrique qui a généré l’exemple.
-
Identité
-
Structure d' _ identité WINBIO qui contient le GUID ou le SID de l’utilisateur qui fournit l’exemple biométrique.
-
Sous-fait
-
Valeur de sous- _ _ type biométrique WINBIO qui spécifie le sous-facteur associé à un échantillon biométrique. le Windows Biometric Framework (WBF) prend actuellement en charge uniquement la capture d’empreintes digitales et utilise les constantes suivantes pour représenter les informations de sous-type.
- WINBIO _ ANSI _ 381 _ pos _ inconnu
- WINBIO _ ANSI _ 381 _ pos _ RH _
- WINBIO _ ANSI _ 381 _ pos _ RH _ index _ Finger
- WINBIO _ ANSI _ 381 _ pos _ hr _ _ Finger Middle
- WINBIO de l' _ _ _ _ anneau RH _ du PDV ANSI 381 _
- WINBIO _ ANSI _ 381 _ pos _ RH _ petit _ Finger
- WINBIO _ ANSI _ 381 _ pos _ LH _
- WINBIO _ ANSI _ 381 _ pos _ LH _ index _ Finger
- WINBIO _ ANSI _ 381 _ pos _ LH _ - _ Finger
- _ _ Doigt Ring WINBIO ANSI 381 _ pos _ LH _ _
- WINBIO _ ANSI _ 381 _ pos _ LH _ petit _ doigt
- WINBIO _ ANSI _ 381 _ pos _ RH _ quatre _ doigts
- WINBIO _ ANSI _ 381 _ pos _ LH _ quatre _ doigts
- WINBIO _ ANSI _ 381 _ pos _ deux _ pouces
Important
N’essayez pas de valider la valeur fournie pour la valeur de sous- fait . le Service de biométrie Windows validera la valeur fournie avant de la passer à votre implémentation. Si la valeur est WINBIO _ sous-type _ aucune _ information ou WINBIO sous- _ type _ any, validez le cas échéant.
-
RejectDetail
-
Valeur ULong qui contient des informations supplémentaires sur l’échec de capture d’un échantillon biométrique. Si la capture a réussi, ce paramètre a la valeur zéro. Les valeurs suivantes sont définies pour la capture d’empreinte digitale :
- WINBIO _ FP _ trop _ élevé
- WINBIO _ FP _ trop _ faible
- WINBIO _ FP _ trop à _ gauche
- WINBIO _ FP _ trop à _ droite
- WINBIO _ FP _ trop _ Fast
- WINBIO _ FP _ trop _ lent
- _ _ qualité médiocre de WINBIO FP _
- WINBIO _ FP _ trop _ incliné
- WINBIO _ FP _ trop _ petit
- échec de la _ fusion WINBIO FP _ _
-
-
Error
-
Structure qui identifie la réussite ou l’échec de l’opération surveillée.
-
ErrorCode
-
valeur HRESULT qui contient _ un ou un code d’erreur qui résulte des calculs effectués par le Windows Biometric Framework.
-
-
Notes
appelez la fonction WinBioRegisterEventMonitor pour inscrire une routine de rappel afin de recevoir des notifications d’événements de la Windows Biometric Framework. Le rappel est une fonction personnalisée que vous devez définir pour votre application.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
applications de [ bureau Windows 7 uniquement] |
| Serveur minimal pris en charge |
Windows Serveur 2008 R2, [ applications de bureau uniquement] |
| En-tête |
|