struttura WINBIO_EVENT

La struttura WINBIO_EVENT contiene informazioni sullo stato inviate alla routine di callback quando viene generato un avviso di evento.

Sintassi

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;

Members

Tipo

Valore che specifica il tipo di avviso di evento del provider di servizi generato. L'unico provider attualmente supportato è il sensore di impronta digitale. Questo sensore supporta i flag seguenti.

WINBIO_EVENT_FP_UNCLAIMED (il sensore ha rilevato uno scorrimento rapido del dito non richiesto dall'applicazione o dalla finestra che attualmente ha lo stato attivo. Windows Biometric Framework chiama la funzione di callback per indicare che si è verificato uno scorrimento rapido del dito, ma non tenta di identificare l'impronta digitale.

WINBIO_EVENT_FP_UNCLAIMED_IDENTIFY (il sensore ha rilevato uno scorrimento rapido del dito che non è stato richiesto dall'applicazione o dalla finestra che attualmente ha lo stato attivo. Windows Biometric Framework tenta di identificare l'impronta digitale e passa il risultato di tale processo alla funzione di callback.

Parameters

Unclaimed

Struttura restituita per l'acquisizione di campioni biometrici.

UnitId

Unità biometrica che ha generato il campione.

RejectDetail

Valore ULONG che contiene informazioni aggiuntive relative all'impossibilità di acquisire un campione biometrico. Se un'acquisizione ha esito positivo, questo parametro viene impostato su zero. Per l'acquisizione delle impronte digitali sono definiti i valori seguenti:

• 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

Struttura restituita per l'acquisizione e l'identificazione biometrica. L'identificazione determina se un campione può essere associato a un modello biometrico esistente.

UnitId

Unità biometrica che ha generato il campione.

Identità

Struttura WINBIO_IDENTITY che contiene il GUID o IL SID dell'utente che fornisce il campione biometrico.

SubFactoring

Valore WINBIO_BIOMETRIC_SUBTYPE che specifica il sotto-fattore associato a un campione biometrico. Windows Biometric Framework (WBF) supporta attualmente solo l'acquisizione delle impronte digitali e usa le costanti seguenti per rappresentare informazioni di sottotipo.

• 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

Importante

Non tentare di convalidare il valore fornito per il valore di SubFactor . Il servizio Windows Biometrics convaliderà il valore fornito prima di passarlo all'implementazione. Se il valore è WINBIO_SUBTYPE_NO_INFORMATION o WINBIO_SUBTYPE_ANY, convalidare la posizione appropriata.

RejectDetail

Valore ULONG che contiene informazioni aggiuntive sull'errore di acquisizione di un campione biometrico. Se l'acquisizione è riuscita, questo parametro è impostato su zero. Per l'acquisizione delle impronte digitali sono definiti i valori seguenti:

• 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 (Errore) (Error (Errore)e)

Struttura che identifica l'esito positivo o negativo dell'operazione monitorata.

ErrorCode

Valore HRESULT che contiene S_OK o un codice di errore risultante dai calcoli eseguiti da Windows Biometric Framework.

Commenti

Chiamare la funzione WinBioRegisterEventMonitor per registrare una routine di callback per ricevere notifiche degli eventi da Windows Biometric Framework. Il callback è una funzione personalizzata che è necessario definire per l'applicazione.

Requisiti

Vedi anche

Strutture dell'applicazione client

WinBioRegisterEventMonitor