다음을 통해 공유

WinBioReleaseFocus 함수(winbio.h)

  • 아티클

창 포커스를 해제합니다.

구문

HRESULT WinBioReleaseFocus();

반환 값

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

반환 코드 Description
E_ACCESSDENIED
 호출 프로세스는 로컬 시스템 계정으로 실행되어야 합니다.

설명

Windows 생체 인식 프레임워크는 창 포커스를 사용하여 시스템 풀에 연결된 여러 세션 간에 중재합니다.

포커스를 얻는 방식은 작성 중인 애플리케이션의 유형에 따라 달라집니다. 예를 들어 GUI 애플리케이션을 만드는 경우 WM_ACTIVATE, WM_SETFOCUS 또는 기타 적절한 메시지를 캡처하는 메시지 처리기를 구현할 수 있습니다. CUI 애플리케이션을 작성하는 경우 GetConsoleWindow 를 호출하여 콘솔 창에 대한 핸들을 검색하고 해당 핸들을 SetForegroundWindow 함수에 전달하여 콘솔 창을 포그라운드로 강제 적용하고 포커스를 할당합니다. 애플리케이션이 분리된 프로세스에서 실행 중이거나 Windows 서비스이고 창이 없는 경우 WinBioAcquireFocus 및 WinBioReleaseFocus 를 사용하여 수동으로 포커스를 제어합니다.

다음 목록에서는 WinBioAcquireFocus 및 WinBioReleaseFocus를 호출하기 전에 고려해야 할 주요 사항을 요약합니다.

  • 호출 프로세스는 로컬 시스템 계정으로 실행되어야 합니다.
  • 사용자 인터페이스를 직접 표시하는 프로세스는 WinBioAcquireFocus를 호출하면 안 됩니다. GUI 및 CUI 애플리케이션에 대한 포커스를 획득하는 방법을 확인하려면 앞의 토론을 참조하세요.
  • 생체 인식 API 호출 중에 사용자 인터페이스를 직접 표시하지 않는 서비스 또는 분리된 프로세스만 이 함수를 호출해야 합니다.
다음 함수를 호출할 때 포커스를 획득하지 않으면 예기치 않은 방식으로 동작합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 winbio.h(Winbio.h 포함)
라이브러리 Winbio.lib
DLL Winbio.dll

추가 정보

클라이언트 애플리케이션 함수

WinBioEnrollBegin