struktur WINBIO_BIR_HEADER

Artikel
06/13/2023

Struktur WINBIO_BIR_HEADER berisi header rekaman informasi biometrik (BIR).

Sintaks

typedef struct _WINBIO_BIR_HEADER {
  USHORT                   ValidFields;
  WINBIO_BIR_VERSION       HeaderVersion;
  WINBIO_BIR_VERSION       PatronHeaderVersion;
  WINBIO_BIR_DATA_FLAGS    DataFlags;
  WINBIO_BIOMETRIC_TYPE    Type;
  WINBIO_BIOMETRIC_SUBTYPE Subtype;
  WINBIO_BIR_PURPOSE       Purpose;
  WINBIO_BIR_QUALITY       DataQuality;
  LARGE_INTEGER            CreationDate;
  struct {
    LARGE_INTEGER BeginDate;
    LARGE_INTEGER EndDate;
  } ValidityPeriod;
  WINBIO_REGISTERED_FORMAT BiometricDataFormat;
  WINBIO_REGISTERED_FORMAT ProductId;
} WINBIO_BIR_HEADER;

Anggota

ValidFields

Bitmask yang menentukan bidang mana dalam struktur ini yang valid. Untuk informasi selengkapnya, lihat WINBIO_BIR_FIELD Konstanta.

HeaderVersion

Konstanta WINBIO_BIR_VERSION yang menentukan versi header. Nomor versi adalah nilai 8-bit di mana empat bit atas menentukan angka utama dan empat bit rendah menentukan nomor versi minor. Saat ini harus WINBIO_CBEFF_HEADER_VERSION (0x11).

PatronHeaderVersion

DataFlags

Nilai yang menentukan format data header. Ini bisa menjadi bitwise ATAU dari bendera tingkat keamanan dan pemrosesan berikut. Untuk informasi selengkapnya, lihat konstanta WINBIO_BIR_DATA_FLAGS.

Nilai	Makna
WINBIO_DATA_FLAG_PRIVACY ((UCHAR)0x02)	Data dienkripsi.
WINBIO_DATA_FLAG_INTEGRITY ((UCHAR)0x01)	Data ditandatangani secara digital atau dilindungi oleh kode autentikasi pesan (MAC).
WINBIO_DATA_FLAG_SIGNED ((UCHAR)0x04)	Jika bendera ini dan bendera WINBIO_DATA_FLAG_INTEGRITY diatur, data akan ditandatangani. Jika bendera ini tidak diatur tetapi bendera WINBIO_DATA_FLAG_INTEGRITY diatur, MAC dihitung melalui data.
WINBIO_DATA_FLAG_RAW ((UCHAR)0x20)	Data dalam format yang diambil.
WINBIO_DATA_FLAG_INTERMEDIATE ((UCHAR)0x40)	Data tidak mentah tetapi belum sepenuhnya diproses.
WINBIO_DATA_FLAG_PROCESSED ((UCHAR)0x80)	Data telah diproses.
WINBIO_DATA_FLAG_OPTION_MASK_PRESENT ((UCHAR)0x08)	Nilai ini selalu 1.

Jenis

Nilai WINBIO_BIOMETRIC_TYPE yang menentukan jenis data biometrik yang direferensikan dalam rekaman informasi biometrik. Saat ini hanya WINBIO_TYPE_FINGERPRINT yang didukung. Untuk informasi selengkapnya, lihat konstanta WINBIO_BIOMETRIC_TYPE.

Subjenis

Nilai WINBIO_BIOMETRIC_SUBTYPE yang menentukan subfaktor yang terkait dengan data biometrik. Untuk informasi selengkapnya, lihat Keterangan dan konstanta WINBIO_BIOMETRIC_SUBTYPE.

Tujuan

Masker WINBIO_BIR_PURPOSE yang menentukan penggunaan data yang dimaksudkan. Ini bisa menjadi bitwise ATAU dari nilai berikut. Untuk informasi selengkapnya, lihat konstanta WINBIO_BIR_PURPOSE.

WINBIO_PURPOSE_VERIFY
WINBIO_PURPOSE_IDENTIFY
WINBIO_PURPOSE_ENROLL
WINBIO_PURPOSE_ENROLL_FOR_VERIFICATION
WINBIO_PURPOSE_ENROLL_FOR_IDENTIFICATION
WINBIO_PURPOSE_AUDIT

DataQuality

Nilai yang menentukan kualitas relatif data biometrik dalam rekaman informasi biometrik (BIR). Ini bisa menjadi bilangan bulat dari 0 hingga 100 atau salah satu nilai berikut. Untuk informasi selengkapnya, lihat konstanta WINBIO_BIR_QUALITY.

Nilai	Makna
WINBIO_DATA_QUALITY_NOT_SET ((WINBIO_BIR_QUALITY)-1)	Pengukuran kualitas didukung oleh pembuat BIR tetapi tidak ada nilai yang ditetapkan dalam BIR.
WINBIO_DATA_QUALITY_NOT_SUPPORTED ((WINBIO_BIR_QUALITY)-2)	Pengukuran kualitas tidak didukung oleh pembuat BIR.

CreationDate

Tanggal dan waktu, dalam Waktu Universal Terkoordinasi (Greenwich Mean Time), bahwa BIR dibuat.

ValidityPeriod

Periode di mana BIR valid.

BeginDate: Tanggal dan waktu, dalam Waktu Universal Terkoordinasi, bahwa periode validitas dimulai.
EndDate: Tanggal dan waktu, dalam Waktu Universal Terkoordinasi, di mana BIR berhenti valid.

BiometricDataFormat

Struktur WINBIO_REGISTERED_FORMAT yang menentukan format data blok data standar dalam struktur WINBIO_BIR . Anggota WINBIO_REGISTERED_FORMAT tidak boleh nol. Anda dapat menggunakan konstanta berikut untuk menyederhanakan pemeriksaan kesalahan.

Nilai	Makna
WINBIO_NO_FORMAT_OWNER_AVAILABLE ((USHORT)0)	Tidak ada nilai pemilik yang ditetapkan IBIA (Asosiasi Industri Biometrik Internasional) yang telah ditentukan.
WINBIO_NO_FORMAT_TYPE_AVAILABLE ((USHORT)0)	Tidak ada tipe format yang ditentukan.

ProductId

Struktur WINBIO_REGISTERED_FORMAT yang menentukan ID produk komponen yang menghasilkan blok data standar di BIR. Anggota WINBIO_REGISTERED_FORMAT bisa nol.

Keterangan

Parameter Subjenis menentukan subfaktor yang terkait dengan data biometrik. Saat ini, Windows Biometric Framework (WBF) 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 parameter Subjenis . 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.

Jika salah satu bit berikut dinyatakan, struktur WINBIO_BIR_HEADER tidak terbentuk dengan benar.

#define WINBIO_BIR_FIELD_NEVER_VALID    (WINBIO_BIR_FIELD_SUBHEAD_COUNT |   \
                                         WINBIO_BIR_FIELD_PATRON_ID |       \
                                         WINBIO_BIR_FIELD_INDEX |           \
                                         WINBIO_BIR_FIELD_CHALLENGE |       \
                                         WINBIO_BIR_FIELD_PAYLOAD )

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
Konstanta WINBIO_BIOMETRIC_SUBTYPE
WINBIO_BIR
Konstanta WINBIO_BIR_DATA_FLAGS
Konstanta WINBIO_BIR_FIELD
Konstanta WINBIO_BIR_PURPOSE
Konstanta WINBIO_BIR_QUALITY
Konstanta WINBIO_BIR_VERSION

Bagikan melalui