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