WINBIO_EVENT structure
La structure WINBIO_EVENT contient status informations envoyées à la routine de rappel lorsqu’une notification d’événement est déclenchée.
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;
-
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’empreinte digitale. Ce capteur prend en charge les indicateurs suivants.
-
WINBIO_EVENT_FP_UNCLAIMED (Le capteur a détecté un balayage du doigt qui n’a pas été demandé par l’application ou par la fenêtre qui a actuellement le focus. L’infrastructure biométrique Windows appelle votre fonction de rappel pour indiquer qu’un balayage du doigt s’est produit, mais qu’il n’essaie pas d’identifier l’empreinte digitale.)
-
WINBIO_EVENT_FP_UNCLAIMED_IDENTIFY (Le capteur a détecté un balayage du doigt qui n’a pas été demandé par l’application ou par la fenêtre qui a actuellement le focus. L’infrastructure biométrique Windows tente d’identifier l’empreinte digitale et transmet le résultat de ce processus à votre fonction de rappel.)
-
-
Paramètres
-
-
Non réclamés
-
Structure retournée pour la capture d’échantillons biométriques.
-
UnitId
-
Unité biométrique qui a généré l’échantillon.
-
RejectDetail
-
Valeur ULONG qui contient des informations supplémentaires concernant l’échec de la capture d’un échantillon biométrique. Si une capture a réussi, ce paramètre est défini sur zéro. Les valeurs suivantes sont définies pour la capture d’empreintes digitales :
- 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
-
Structure retournée pour la capture et l’identification biométriques. L’identification détermine si un échantillon peut être associé à un modèle biométrique existant.
-
UnitId
-
Unité biométrique qui a généré l’échantillon.
-
Identité
-
Structure WINBIO_IDENTITY qui contient le GUID ou le SID de l’utilisateur qui fournit l’échantillon biométrique.
-
Sous-facteur
-
Valeur WINBIO_BIOMETRIC_SUBTYPE qui spécifie le sous-facteur associé à un échantillon biométrique. L’infrastructure biométrique Windows (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_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
Important
N’essayez pas de valider la valeur fournie pour la valeur SubFactor . Le service de biométrie Windows valide la valeur fournie avant de la transmettre à votre implémentation. Si la valeur est WINBIO_SUBTYPE_NO_INFORMATION ou WINBIO_SUBTYPE_ANY, validez le cas échéant.
-
RejectDetail
-
Valeur ULONG qui contient des informations supplémentaires sur l’échec de la capture d’un échantillon biométrique. Si la capture a réussi, ce paramètre est défini sur zéro. Les valeurs suivantes sont définies pour la capture d’empreintes digitales :
- 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
-
-
Error
-
Structure qui identifie la réussite ou l’échec de l’opération supervisée.
-
ErrorCode
-
Valeur HRESULT qui contient S_OK ou un code d’erreur résultant des calculs effectués par l’infrastructure biométrique Windows.
-
-
Appelez la fonction WinBioRegisterEventMonitor pour inscrire une routine de rappel afin de recevoir des notifications d’événements à partir de l’infrastructure biométrique Windows. Le rappel est une fonction personnalisée que vous devez définir pour votre application.
Condition requise | Valeur |
---|---|
Client minimal pris en charge |
Windows 7 [applications de bureau uniquement] |
Serveur minimal pris en charge |
Windows Server 2008 R2 [applications de bureau uniquement] |
En-tête |
|