WINBIO_EVENT 구조체
WINBIO_EVENT 구조에는 이벤트 알림이 발생할 때 콜백 루틴으로 전송되는 상태 정보가 포함됩니다.
구문
typedef struct _WINBIO_EVENT {
WINBIO_EVENT_TYPE Type;
union {
struct {
WINBIO_UNIT_ID UnitId;
WINBIO_REJECT_DETAIL RejectDetail;
} Unclaimed;
struct {
WINBIO_UNIT_ID UnitId;
WINBIO_IDENTITY Identity;
WINBIO_BIOMETRIC_SUBTYPE SubFactor;
WINBIO_REJECT_DETAIL RejectDetail;
} UnclaimedIdentify;
struct {
HRESULT ErrorCode;
} Error;
} Parameters;
} WINBIO_EVENT, *PWINBIO_EVENT;
멤버
-
형식
-
발생한 서비스 공급자 이벤트 알림의 유형을 지정하는 값입니다. 현재 지원되는 유일한 공급자는 지문 센서입니다. 이 센서는 다음 플래그를 지원합니다.
-
WINBIO_EVENT_FP_UNCLAIMED (센서가 애플리케이션 또는 현재 포커스가 있는 창에서 요청되지 않은 손가락 살짝 밀기를 감지했습니다. Windows 생체 인식 프레임워크는 콜백 함수를 호출하여 손가락 살짝 밀기 발생했지만 지문을 식별하지 않음을 나타냅니다.)
-
WINBIO_EVENT_FP_UNCLAIMED_IDENTIFY (센서가 애플리케이션 또는 현재 포커스가 있는 창에서 요청되지 않은 손가락 살짝 밀기를 감지했습니다. Windows 생체 인식 프레임워크는 지문을 식별하려고 시도하고 해당 프로세스의 결과를 콜백 함수에 전달합니다.)
-
-
매개 변수
-
-
미청구
-
생체 인식 샘플 캡처를 위해 반환된 구조체입니다.
-
UnitId
-
샘플을 생성한 생체 인식 단위입니다.
-
RejectDetail
-
생체 인식 샘플 캡처 실패에 대한 추가 정보가 포함된 ULONG 값입니다. 캡처에 성공하면 이 매개 변수가 0으로 설정됩니다. 지문 캡처에 대해 정의된 값은 다음과 같습니다.
- WINBIO_FP_TOO_HIGH
- WINBIO_FP_TOO_LOW
- WINBIO_FP_TOO_LEFT
- WINBIO_FP_TOO_RIGHT
- WINBIO_FP_TOO_FAST
- WINBIO_FP_TOO_SLOW
- WINBIO_FP_POOR_QUALITY
- WINBIO_FP_TOO_SKEWED
- WINBIO_FP_TOO_SHORT
- WINBIO_FP_MERGE_FAILURE
-
-
UnclaimedIdentify
-
생체 인식 캡처 및 식별을 위해 반환된 구조체입니다. 식별은 샘플을 기존 생체 인식 템플릿과 연결할 수 있는지 여부를 결정합니다.
-
UnitId
-
샘플을 생성한 생체 인식 단위입니다.
-
ID
-
생체 인식 샘플을 제공하는 사용자의 GUID 또는 SID를 포함하는 WINBIO_IDENTITY 구조체입니다.
-
SubFactor
-
생체 인식 샘플과 연결된 하위 요소를 지정하는 WINBIO_BIOMETRIC_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
중요
SubFactor 값에 대해 제공된 값의 유효성을 검사하지 마세요. Windows 생체 인식 서비스는 제공된 값을 구현에 전달하기 전에 유효성을 검사합니다. 값이 WINBIO_SUBTYPE_NO_INFORMATION 또는 WINBIO_SUBTYPE_ANY 경우 적절한 경우 유효성을 검사합니다.
-
RejectDetail
-
생체 인식 샘플을 캡처하지 못한 것에 대한 추가 정보가 포함된 ULONG 값입니다. 캡처에 성공하면 이 매개 변수가 0으로 설정됩니다. 지문 캡처에 대해 정의된 값은 다음과 같습니다.
- WINBIO_FP_TOO_HIGH
- WINBIO_FP_TOO_LOW
- WINBIO_FP_TOO_LEFT
- WINBIO_FP_TOO_RIGHT
- WINBIO_FP_TOO_FAST
- WINBIO_FP_TOO_SLOW
- WINBIO_FP_POOR_QUALITY
- WINBIO_FP_TOO_SKEWED
- WINBIO_FP_TOO_SHORT
- WINBIO_FP_MERGE_FAILURE
-
-
오류
-
모니터링되는 작업의 성공 또는 실패를 식별하는 구조체입니다.
-
ErrorCode
-
Windows 생체 인식 프레임워크에서 수행한 계산으로 인해 발생한 S_OK 또는 오류 코드가 포함된 HRESULT 값입니다.
-
-
설명
WinBioRegisterEventMonitor 함수를 호출하여 Windows 생체 인식 프레임워크에서 이벤트 알림을 수신하는 콜백 루틴을 등록합니다. 콜백은 애플리케이션에 대해 정의해야 하는 사용자 지정 함수입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 헤더 |
|