WinBioEnrollSelect 함수(winbio.h)

여러 개인을 나타내는 데이터가 샘플 버퍼에 있을 때 등록하려는 개인을 지정합니다. Windows 10 빌드 1607부터 이 함수를 모바일 이미지와 함께 사용할 수 있습니다.

구문

HRESULT WinBioEnrollSelect(
  [in] WINBIO_SESSION_HANDLE SessionHandle,
  [in] ULONGLONG             SelectorValue
);

매개 변수

[in] SessionHandle

열린 생체 인식 세션을 식별하는 WINBIO_SESSION_HANDLE 값입니다. WinBioOpenSession을 호출하여 동기 세션 핸들을 엽니다. WinBioAsyncOpenSession을 호출하여 비동기 세션 핸들을 엽니다.

얼굴 인식 등록의 경우 PoolType 매개 변수를 WINBIO_POOL_SYSTEM 설정하여 WinBioAsyncOpenSession을 사용하여 핸들을 가져옵니다.

[in] SelectorValue

등록을 위해 선택하려는 개인을 식별하는 값입니다.

반환 값

함수가 성공하면 S_OK를 반환합니다. 함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.

설명

얼굴 인식 등록의 경우 다음 두 가지 방법 중 하나로 올바른 선택기 값을 찾을 수 있습니다.

• 이전에 보낸 WINBIO_PRESENCE 구조체 중 하나의 ID 멤버 값입니다.
• NUI 얼굴 추적 API에서 생성된 데이터입니다.

지문과 같이 명확성이 필요하지 않은 생체 인식 요인에 대해 WinBioEnrollSelect 를 호출하는 경우 함수의 반환 값은 성공을 나타내지만 함수는 선택기 값을 무시합니다.

함수를 호출해야 하는 생체 인식 요소에 대해 WinBioEnrollSelect 를 호출하지 않으면 WinBioEnrollCapture 에 대한 후속 호출이 실패하고 WINBIO_E_SELECTION_REQUIRED 오류가 발생합니다.

Windows 10 경우 WinBioEnrollSelect를 호출해야 하는 요소는 얼굴 특징과 홍채입니다.

동기 또는 비동기 세션 핸들을 사용하여 WinBioEnrollSelect 를 호출할 수 있습니다. Windows 생체 인식 프레임워크 API 함수에 대한 다른 호출과 마찬가지로 비동기 세션 핸들을 사용하여 WinBioEnrollSelect 를 호출할 때 반환 값은 함수 매개 변수만 허용됨을 나타냅니다. 작업 자체의 실제 성공 또는 실패는 WINBIO_ASYNC_RESULT 구조에서 알림 루틴으로 반환됩니다.

요구 사항

추가 정보

WINBIO_ASYNC_RESULT

WINBIO_PRESENCE

WinBioEnrollBegin

WinBioEnrollCapture

WinBioEnrollCommit

WinBioEnrollDiscard