PIBIO_ENGINE_QUERY_EXTENDED_ENROLLMENT_STATUS_FN 콜백 함수(winbio_adapter.h)

클라이언트 애플리케이션이 WINBIO_PROPERTY_EXTENDED_ENROLLMENT_STATUS 속성을 쿼리할 때 Windows 생체 인식 프레임워크에서 호출됩니다.

구문

PIBIO_ENGINE_QUERY_EXTENDED_ENROLLMENT_STATUS_FN PibioEngineQueryExtendedEnrollmentStatusFn;

HRESULT PibioEngineQueryExtendedEnrollmentStatusFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PWINBIO_EXTENDED_ENROLLMENT_STATUS EnrollmentStatus,
  [in]      SIZE_T EnrollmentStatusSize
)
{...}

매개 변수

[in, out] Pipeline

작업을 수행하는 생체 인식 단위와 연결된 WINBIO_PIPELINE 구조체에 대한 포인터입니다.

[out] EnrollmentStatus

이 함수에서 반환하는 확장 등록 상태 정보를 포함하는 WINBIO_EXTENDED_ENROLLMENT_STATUS 구조체에 대한 포인터입니다.

[in] EnrollmentStatusSize

확장 등록 상태 정보의 지정된 크기(바이트)입니다.

반환 값

함수가 성공하면 S_OK를 반환합니다. 함수가 실패하는 경우 오류를 나타내려면 다음 HRESULT 값 중 하나를 반환해야 합니다.

반환 코드	설명
E_POINTER	Pipeline 매개 변수는 NULL일 수 없습니다.
E_INVALIDARG	EnrollmentStatusSize 매개 변수는 출력 버퍼가 너무 작다는 것을 나타냅니다.

설명

등록 애플리케이션은 WinBioEnrollCapture 함수를 호출할 때마다 확장 등록 상태 정보를 요청할 수 있습니다.

이 루틴을 호출할 때 생체 인식 단위가 현재 등록 템플릿이 아닌 경우 엔진 어댑터는 EnrollmentStatus.TemplateStatus 필드를 WINBIO_E_INVALID_OPERATION 설정하고 S_OK 함수 값으로 반환해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winbio_adapter.h(Winbio_adapter.h 포함)