WinBioMonitorPresence 함수(winbio.h)

지정된 생체 인식 단위에 대한 얼굴 인식 또는 홍채 모니터링 메커니즘을 켭니다. Windows 10 빌드 1607부터 이 함수를 모바일 이미지와 함께 사용할 수 있습니다.

구문

HRESULT WinBioMonitorPresence(
  [in] WINBIO_SESSION_HANDLE SessionHandle,
  [in] WINBIO_UNIT_ID        UnitId
);

매개 변수

[in] SessionHandle

PoolType 매개 변수가 WINBIO_POOL_SYSTEM 설정된 WinBioAsyncOpenSession 함수를 호출하여 얻은 생체 인식 세션에 대한 비동기 핸들입니다.

[in] UnitId

얼굴 인식 또는 홍채 모니터링 메커니즘을 켜려는 생체 인식 단위의 식별자입니다.

반환 값

함수 매개 변수가 허용되는 경우 S_OK 반환합니다. 함수 매개 변수가 허용되지 않는 경우 오류를 나타내는 HRESULT 값을 반환합니다.
가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.

작업 자체의 실제 성공 또는 실패는 WINBIO_ASYNC_RESULT 구조의 알림 함수로 반환됩니다.

설명

단일 생체 인식 세션에는 언제든지 활성 상태 모니터가 하나만 있을 수 있습니다.

WinBioMonitorPresence를 성공적으로 호출하면 알림 함수는 WINBIO_OPERATION_MONITOR_PRESENCE 동일한 Operation 멤버가 있는 WINBIO_ASYNC_RESULT 구조 형식의 알림을 받습니다. 그런 다음, 자세한 내용은 WINBIO_ASYNC_RESULT 구조체의 Parameters.MonitorPresence 멤버를 검사해야 합니다.

알림 수신을 중지하려면 원래 비동기 핸들 값을 사용하여 WinBioCancel 또는 WinBioCloseSession 을 호출합니다.

요구 사항

추가 정보

WINBIO_ASYNC_RESULT

WinBioAsyncOpenSession

WinBioCancel

WinBioCloseSession