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입니다. -
형식
-
생체 정보 레코드에서 참조되는 생체 인식 데이터의 형식을 지정하는 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가 유효하지 않은 협정 세계시의 날짜 및 시간입니다.
-
-
BiometricDataFormat
-
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일 수 있습니다.
설명
Subtype 매개 변수는 생체 인식 데이터와 연결된 하위 요소를 지정합니다. 현재 WBF(Windows 생체 인식 프레임워크)는 지문 캡처만 지원하며 다음 상수를 사용하여 하위 형식 정보를 나타냅니다.
- 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
중요
Subtype 매개 변수 값에 제공된 값의 유효성을 검사하지 마세요. 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 [데스크톱 앱만 해당] |
| 헤더 |
|