WINBIO_BIR_HEADER構造体

[アーティクル]
06/13/2023

WINBIO_BIR_HEADER構造体には、生体情報レコード (BIR) のヘッダーが含まれています。

構文

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;

メンバー

ValidFields

この構造体のどのフィールドが有効であるかを指定するビットマスク。詳細については、「 定数のWINBIO_BIR_FIELD」を参照してください。

HeaderVersion

ヘッダーのバージョンを指定する WINBIO_BIR_VERSION 定数。バージョン番号は、上位 4 ビットがメジャー番号を指定し、下位 4 ビットがマイナーバージョン番号を指定する 8 ビット値です。現在、これはWINBIO_CBEFF_HEADER_VERSION (0x11) である必要があります。

PatronHeaderVersion

ヘッダーのバージョンを指定する WINBIO_BIR_VERSION 定数。バージョン番号は、上位 4 ビットがメジャー番号を指定し、下位 4 ビットがマイナーバージョン番号を指定する 8 ビット値です。現在、これはWINBIO_PATRON_HEADER_VERSION (0x11) である必要があります。

DataFlags

ヘッダーデータの形式を示す値。これは、次のセキュリティおよび処理レベルフラグのビットごとの OR にすることができます。詳細については、「 定数のWINBIO_BIR_DATA_FLAGS」を参照してください。

値	説明
WINBIO_DATA_FLAG_PRIVACY ((UCHAR)0x02)	データは暗号化されています。
WINBIO_DATA_FLAG_INTEGRITY ((UCHAR)0x01)	データは、メッセージ認証コード (MAC) によってデジタル署名または保護されます。
WINBIO_DATA_FLAG_SIGNED ((UCHAR)0x04)	このフラグと WINBIO_DATA_FLAG_INTEGRITY フラグが設定されている場合、データは署名されます。このフラグが設定されていないが、WINBIO_DATA_FLAG_INTEGRITY フラグが設定されている場合、MAC はデータに対して計算されます。
WINBIO_DATA_FLAG_RAW ((UCHAR)0x20)	データは、キャプチャされた形式です。
WINBIO_DATA_FLAG_INTERMEDIATE ((UCHAR)0x40)	データは生ではなく、完全に処理されていません。
WINBIO_DATA_FLAG_PROCESSED ((UCHAR)0x80)	データが処理されました。
WINBIO_DATA_FLAG_OPTION_MASK_PRESENT ((UCHAR)0x08)	この値は常に 1 です。

Type

生体情報レコードで参照される生体認証データの種類を指定するWINBIO_BIOMETRIC_TYPE値。現在、 WINBIO_TYPE_FINGERPRINT のみがサポートされています。詳細については、「 定数のWINBIO_BIOMETRIC_TYPE」を参照してください。

サブタイプ

生体認証データに関連付けられているサブ要素を指定する WINBIO_BIOMETRIC_SUBTYPE 値。詳細については、「解説」および「 WINBIO_BIOMETRIC_SUBTYPE定数」を参照してください。

目的

データの使用目的を指定する WINBIO_BIR_PURPOSE マスク。これは、次の値のビットごとの OR にすることができます。詳細については、「 定数の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

生体情報レコード (BIR) 内の生体認証データの相対的な品質を示す値。 0 ~ 100 の整数、または次のいずれかの値を指定できます。詳細については、「 定数のWINBIO_BIR_QUALITY」を参照してください。

値	説明
WINBIO_DATA_QUALITY_NOT_SET ((WINBIO_BIR_QUALITY)-1)	品質測定は BIR 作成者によってサポートされていますが、BIR に値が設定されていません。
WINBIO_DATA_QUALITY_NOT_SUPPORTED ((WINBIO_BIR_QUALITY)-2)	品質測定は BIR 作成者によってサポートされていません。

CreationDate

BIR が作成された日時 (協定世界時 (グリニッジ標準時)。

ValidityPeriod

BIR が有効な期間。

BeginDate: 有効期間が開始される協定世界時の日付と時刻。
EndDate: BIR が有効でなくなる日時 (協定世界時)。

生体認証DataFormat

WINBIO_BIR構造体の標準データブロックのデータ形式を指定するWINBIO_REGISTERED_FORMAT構造体。 WINBIO_REGISTERED_FORMAT メンバーを 0 にすることはできません。次の定数を使用すると、エラーチェックを簡略化できます。

値	説明
WINBIO_NO_FORMAT_OWNER_AVAILABLE ((USHORT)0)	IBIA (国際生体認証産業協会) に割り当てられた所有者の値が指定されていません。
WINBIO_NO_FORMAT_TYPE_AVAILABLE ((USHORT)0)	書式の種類が指定されていません。

ProductId

BIR で標準データブロックを生成したコンポーネントの製品 ID を指定するWINBIO_REGISTERED_FORMAT構造体。 WINBIO_REGISTERED_FORMATメンバーは 0 にすることができます。

注釈

サブタイプ パラメーターは、生体認証データに関連付けられているサブ要素を指定します。現在、Windows 生体認証フレームワーク (WBF) は指紋キャプチャのみをサポートし、次の定数を使用してサブタイプ情報を表します。

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

重要

サブタイプ パラメーター値に指定された値の検証を試みないでください。 Windows 生体認証サービスは、指定された値を検証してから実装に渡します。値が WINBIO_SUBTYPE_NO_INFORMATION または WINBIO_SUBTYPE_ANY場合は、必要に応じて検証します。

次のビットのいずれかがアサートされている場合、 WINBIO_BIR_HEADER 構造体は正しく形成されません。

#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 )

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
Header	Winbio_types.h (Winbio.h を含む)

Share via

WINBIO_BIR_HEADER構造体

構文

メンバー

注釈

要件

関連項目

フィードバック

フィードバック

その他のリソース