WinBioGetEnrolledFactors 함수(winbio.h)
지정된 사용자가 컴퓨터에 가지고 있는 생체 인식 등록에 대한 정보를 가져옵니다. 생체 인식 등록에는 얼굴 인식, 지문 스캔, 홍채 스캔 등에 대한 등록이 포함됩니다.
구문
HRESULT WinBioGetEnrolledFactors(
[in] WINBIO_IDENTITY *AccountOwner,
[out] WINBIO_BIOMETRIC_TYPE *EnrolledFactors
);
매개 변수
[in] AccountOwner
생체 인식 등록을 가져올 사용자의 WINBIO_IDENTITY 구조입니다. 예를 들면 다음과 같습니다.
WINBIO_IDENTITY identity = {};
identity.Type = WINBIO_ID_TYPE_SID;
// Move an account SID into identity.Value.AccountSid.Data.
// For example, CopySid(...)
컴퓨터의 모든 사용자에 대한 등록을 보려면 AccountOwner 매개 변수에 대해 지정한 WINBIO_IDENTITY 구조에 대한 WINBIO_ID_TYPE_WILDCARD ID 유형을 지정합니다. 예를 들면 다음과 같습니다.
WINBIO_IDENTITY identity = {};
identity.Type = WINBIO_ID_TYPE_WILDCARD;
[out] EnrolledFactors
지정된 사용자가 컴퓨터에 가지고 있는 생체 인식 등록을 나타내는 WINBIO_BIOMETRIC_TYPE 플래그 집합입니다. 값이 0이면 사용자에게 생체 인식 등록이 없음을 나타냅니다.
이러한 등록은 로그인, 잠금 해제 등에 대해 사용자를 인증하는 데 사용할 수 있는 등록과 같은 시스템 풀 등록만 나타냅니다. 이 값에는 프라이빗 풀 등록이 포함되지 않습니다.
AccountOwner 매개 변수에 사용하는 WINBIO_IDENTITY 구조체에 와일드카드 ID 유형을 지정하는 경우 이 플래그 집합은 컴퓨터에서 계정을 사용하는 모든 사용자에 대해 결합된 등록 집합을 나타냅니다.
반환 값
함수가 성공하면 S_OK를 반환합니다. 함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.
| 반환 코드 | 설명 |
|---|---|
|
AccountOwner 및 EnrolledFactors 매개 변수는 NULL일 수 없습니다. |
|
AccountOnwer 매개 변수가 지정한 WINBIO_IDENTITY 구조체의 Type 멤버가 WINBIO_ID_TYPE_SID 또는 WINBIO_ID_TYPE_WILDCARD 않았거나 WINBIO_IDENTITY 구조체의 AccountSid 멤버가 잘못되었습니다. |
설명
WinBioGetEnrolledFactors 는 생체 인식 세션 핸들이 필요하지 않으며 생체 인식 서비스를 활성화하지 않습니다. 따라서 WinBioGetEnrolledFactors 는 빠르게 실행되며, 코드가 수행해야 하는 작업 집합에 시간이 중요한 경우 진행하는 방법을 빠르게 결정해야 하는 경우에 유용합니다.
WinBioGetEnrolledFactors 는 자격 증명 공급자에게 UI를 적절하게 조정할 수 있는 방법을 제공합니다. 예를 들어 로그인 화면에서 WinBioGetEnrolledFactors 를 호출하여 지문으로 로그인하는 옵션을 표시할지 여부를 결정합니다.
예제
WINBIO_BIOMETRIC_TYPE enrolledFactors = WINBIO_NO_TYPE_AVAILABLE;
WINBIO_IDENTITY identity = {};
identity.Type = WINBIO_ID_TYPE_SID;
// Move an account SID into identity.Value.AccountSid.Data.
// e.g., CopySid(...)
HRESULT hr = WinBioGetEnrolledFactors(&identity, &enrolledFactors);
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winbio.h |
| 라이브러리 | Winbio.lib |
| DLL | Winbio.dll |