次の方法で共有


WINBIO_BIR_HEADER構造体

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 を含む)

関連項目

クライアント アプリケーションの構造

WINBIO_BIOMETRIC_SUBTYPE定数

WINBIO_BIR

WINBIO_BIR_DATA_FLAGS定数

WINBIO_BIR_FIELD定数

WINBIO_BIR_PURPOSE定数

WINBIO_BIR_QUALITY定数

WINBIO_BIR_VERSION定数