WinBioAsyncEnumServiceProviders 함수(winbio.h)

설치된 생체 인식 서비스 공급자에 대한 정보를 비동기적으로 반환합니다. Windows 10 빌드 1607부터 이 함수를 모바일 이미지와 함께 사용할 수 있습니다. 이 함수의 동기 버전은 WinBioEnumServiceProviders를 참조하세요.

구문

HRESULT WinBioAsyncEnumServiceProviders(
  [in] WINBIO_FRAMEWORK_HANDLE FrameworkHandle,
  [in] WINBIO_BIOMETRIC_TYPE   Factor
);

매개 변수

[in] FrameworkHandle

WinBioAsyncOpenFramework를 호출하여 연 프레임워크 세션에 대한 핸들입니다.

[in] Factor

열거할 생체 인식 서비스 공급자 유형을 지정하는 WINBIO_BIOMETRIC_TYPE 플래그의 비트 마스크입니다. Windows 8의 경우 WINBIO_TYPE_FINGERPRINT 만 지원됩니다.

반환 값

함수는 성공 또는 실패를 나타내는 HRESULT 를 반환합니다. 성공 은 함수의 인수가 유효했음을 나타냅니다. 작업을 실행하는 동안 발생한 오류는 WinBioAsyncOpenFramework 호출에 지정된 알림 메서드를 사용하여 WINBIO_ASYNC_RESULT 구조체에 비동기적으로 반환됩니다.

설명

WinBioAsyncEnumServiceProviders 함수는 WinBioAsyncOpenFramework를 호출하여 연 프레임워크 세션에 대한 핸들을 사용합니다. 프레임워크는 WINBIO_ASYNC_RESULT 구조를 할당하고 이를 사용하여 작업 성공 또는 실패에 대한 정보를 반환합니다. 열거형 작업이 성공하면 프레임워크는 열거된 각 공급자에 대한 정보를 포함하는 스키마 배열을 반환합니다. 작업이 실패하면 프레임워크는 WINBIO_ASYNC_RESULT 구조를 사용하여 오류 정보를 반환합니다. 구조체는 WinBioAsyncOpenFramework 함수의 NotificationMethod 매개 변수에 설정한 값에 따라 애플리케이션 콜백 또는 애플리케이션 메시지 큐로 반환됩니다.

• 콜백을 사용하여 완료 알림을 수신하도록 선택하는 경우 PWINBIO_ASYNC_COMPLETION_CALLBACK 함수를 구현하고 NotificationMethod 매개 변수를 WINBIO_ASYNC_NOTIFY_CALLBACK 설정해야 합니다.
• 애플리케이션 메시지 큐를 사용하여 완료 알림을 수신하도록 선택하는 경우 NotificationMethod 매개 변수를 WINBIO_ASYNC_NOTIFY_MESSAGE 설정해야 합니다. 프레임워크는 창 메시지의 LPARAM 필드에 대한 WINBIO_ASYNC_RESULT 포인터를 반환합니다.

WinBioAsyncEnumServiceProviders를 호출하면 단일 알림이 클라이언트 애플리케이션으로 전송됩니다.

요구 사항

추가 정보

WinBioAsyncOpenFramework