Lire en anglais

Partager via


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.

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’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.

Notes

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.

Spécifications

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
Winbio_types.h (inclure Winbio.h)

Voir aussi

Structures d’application cliente

WinBioRegisterEventMonitor