WinBioAsyncMonitorFrameworkChanges 함수(winbio.h)

생체 인식 프레임워크 변경에 대한 비동기 모니터를 시작합니다. 현재 지원되는 유일한 모니터링 변경 내용은 생체 인식 단위가 컴퓨터에 연결되거나 컴퓨터에서 분리될 때 발생합니다.

구문

HRESULT WinBioAsyncMonitorFrameworkChanges(
  [in] WINBIO_FRAMEWORK_HANDLE      FrameworkHandle,
  [in] WINBIO_FRAMEWORK_CHANGE_TYPE ChangeTypes
);

매개 변수

[in] FrameworkHandle

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

[in] ChangeTypes

비동기 알림을 생성해야 하는 이벤트 유형을 나타내는 WINBIO_FRAMEWORK_CHANGE_TYPE 형식의 비트 마스크 플래그입니다. Windows 8 시작하여 다음 플래그를 사용할 수 있습니다.

반환 값

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

설명

시작되면 이 모니터는 클라이언트 애플리케이션이 WinBioCancel 또는 WinBioCloseFramework를 호출할 때까지 이벤트를 계속 생성합니다. WINBIO_FRAMEWORK_CHANGE_UNIT 이벤트에 대한 모니터를 만들면 두 가지 유형의 비동기 알림이 생성됩니다.

WinBioAsyncMonitorFrameworkChanges 함수는 WinBioAsyncOpenFramework를 호출하여 연 프레임워크 세션에 대한 핸들을 사용합니다. 프레임워크는 WINBIO_ASYNC_RESULT 구조를 할당하고 이를 사용하여 작업 성공 또는 실패에 대한 정보를 반환합니다. 생체 인식 단위가 컴퓨터에 연결되거나 컴퓨터에서 분리된 경우 프레임워크는 구조체의 Operation 멤버를 설정합니다. 작업 중에 문제가 발생하면 프레임워크는 WINBIO_ASYNC_RESULT 구조를 사용하여 오류 정보를 반환합니다. 구조체는 WinBioAsyncOpenFramework 함수의 NotificationMethod 매개 변수에 설정한 값에 따라 애플리케이션 콜백 또는 애플리케이션 메시지 큐로 반환됩니다.

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

요구 사항

추가 정보

WinBioAsyncOpenFramework