struktur WINBIO_EVENT

Struktur WINBIO_EVENT berisi informasi status yang dikirim ke rutinitas panggilan balik saat pemberitahuan peristiwa dinaikkan.

Sintaks

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;

Anggota

Jenis

Nilai yang menentukan jenis pemberitahuan peristiwa penyedia layanan yang dimunculkan. Satu-satunya penyedia yang saat ini didukung adalah sensor sidik jari. Sensor ini mendukung bendera berikut.

WINBIO_EVENT_FP_UNCLAIMED (Sensor mendeteksi geser jari yang tidak diminta oleh aplikasi atau oleh jendela yang saat ini memiliki fokus. Windows Biometric Framework memanggil ke fungsi panggilan balik Anda untuk menunjukkan bahwa gesek jari telah terjadi tetapi tidak mencoba mengidentifikasi sidik jari.)

WINBIO_EVENT_FP_UNCLAIMED_IDENTIFY (Sensor mendeteksi geser jari yang tidak diminta oleh aplikasi atau oleh jendela yang saat ini memiliki fokus. Windows Biometric Framework mencoba mengidentifikasi sidik jari dan meneruskan hasil proses tersebut ke fungsi panggilan balik Anda.)

Parameter

Tidak diklaim

Struktur dikembalikan untuk pengambilan sampel biometrik.

UnitId

Unit biometrik yang menghasilkan sampel.

RejectDetail

Nilai ULONG yang berisi informasi tambahan mengenai kegagalan untuk menangkap sampel biometrik. Jika penangkapan berhasil, parameter ini diatur ke nol. Nilai berikut didefinisikan untuk pengambilan sidik jari:

• 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

Struktur dikembalikan untuk penangkapan dan identifikasi biometrik. Identifikasi menentukan apakah sampel dapat dikaitkan dengan templat biometrik yang ada.

UnitId

Unit biometrik yang menghasilkan sampel.

Identitas

Struktur WINBIO_IDENTITY yang berisi GUID atau SID pengguna yang menyediakan sampel biometrik.

SubFaktor

Nilai WINBIO_BIOMETRIC_SUBTYPE yang menentukan subfaktor yang terkait dengan sampel biometrik. Windows Biometric Framework (WBF) saat ini hanya mendukung pengambilan sidik jari dan menggunakan konstanta berikut untuk mewakili informasi subtipe.

• 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

Penting

Jangan mencoba memvalidasi nilai yang disediakan untuk nilai SubFactor . Layanan Biometrik Windows akan memvalidasi nilai yang disediakan sebelum meneruskannya ke implementasi Anda. Jika nilainya WINBIO_SUBTYPE_NO_INFORMATION atau WINBIO_SUBTYPE_ANY, validasi jika sesuai.

RejectDetail

Nilai ULONG yang berisi informasi tambahan tentang kegagalan untuk menangkap sampel biometrik. Jika pengambilan berhasil, parameter ini diatur ke nol. Nilai berikut didefinisikan untuk pengambilan sidik jari:

• 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

Kesalahan

Struktur yang mengidentifikasi keberhasilan atau kegagalan operasi yang dipantau.

ErrorCode

Nilai HRESULT yang berisi S_OK atau kode kesalahan yang dihasilkan dari komputasi yang dilakukan oleh Windows Biometric Framework.

Keterangan

Panggil fungsi WinBioRegisterEventMonitor untuk mendaftarkan rutinitas panggilan balik untuk menerima pemberitahuan peristiwa dari Windows Biometric Framework. Panggilan balik adalah fungsi kustom yang harus Anda tentukan untuk aplikasi Anda.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Header	Winbio_types.h (termasuk Winbio.h)

Lihat juga

Struktur Aplikasi Klien

WinBioRegisterEventMonitor