다음을 통해 공유

WinBioOpenSession 함수(winbio.h)

  • 아티클

생체 인식 서비스 공급자 및 하나 이상의 생체 인식 단위에 연결합니다.

구문

HRESULT WinBioOpenSession(
  [in]  WINBIO_BIOMETRIC_TYPE Factor,
  [in]  WINBIO_POOL_TYPE      PoolType,
  [in]  WINBIO_SESSION_FLAGS  Flags,
  [in]  WINBIO_UNIT_ID        *UnitArray,
  [in]  SIZE_T                UnitCount,
  [in]  GUID                  *DatabaseId,
  [out] WINBIO_SESSION_HANDLE *SessionHandle
);

매개 변수

[in] Factor

열거할 생체 인식 단위 유형을 지정하는 WINBIO_BIOMETRIC_TYPE 플래그의 비트 마스크입니다. 현재 WINBIO_TYPE_FINGERPRINT 만 지원됩니다.

[in] PoolType

세션에서 사용할 생체 인식 단위의 형식을 지정하는 ULONG 값입니다. 다음 값 중 하나일 수 있습니다.

값 의미
WINBIO_POOL_SYSTEM
 세션은 서비스 공급자가 관리하는 생체 인식 단위의 공유 컬렉션에 연결합니다.
WINBIO_POOL_PRIVATE
 세션은 호출자가 관리하는 생체 인식 단위 컬렉션에 연결합니다.

[in] Flags

새 세션의 생체 인식 단위 구성 및 액세스 특성을 지정하는 ULONG 값입니다. 구성 플래그는 세션에서 단위의 일반 구성을 지정합니다. 액세스 플래그는 애플리케이션이 생체 인식 단위를 사용하는 방법을 지정합니다. 하나의 구성 플래그를 지정해야 하지만 해당 플래그를 액세스 플래그와 결합할 수 있습니다.

값 의미
WINBIO_FLAG_DEFAULT
 그룹: 구성

생체 인식 단위는 설치 중에 지정된 방식으로 작동합니다. PoolType 매개 변수가 WINBIO_POOL_SYSTEM 경우 이 값을 사용해야 합니다.
WINBIO_FLAG_BASIC
 그룹: 구성

생체 인식 단위는 기본 캡처 디바이스로만 작동합니다. 모든 처리, 일치 및 스토리지 작업은 소프트웨어 플러그 인에서 수행됩니다.
WINBIO_FLAG_ADVANCED
 그룹: 구성

생체 인식 단위는 내부 처리 및 스토리지 기능을 사용합니다.
WINBIO_FLAG_RAW
 그룹: 액세스

클라이언트 애플리케이션은 WinBioCaptureSample을 사용하여 원시 생체 인식 데이터를 캡처합니다.
WINBIO_FLAG_MAINTENANCE
 그룹: 액세스

클라이언트는 WinBioControlUnitPrivileged를 호출하여 생체 인식 단위에서 공급업체 정의 제어 작업을 수행합니다.

[in] UnitArray

세션에 포함할 생체 인식 단위 식별자 배열에 대한 포인터입니다. WinBioEnumBiometricUnits를 호출하여 생체 인식 단위를 열거할 수 있습니다. PoolType 매개 변수가 WINBIO_POOL_SYSTEM 경우 이 값을 NULL로 설정합니다.

[in] UnitCount

UnitArray 매개 변수가 가리키는 배열의 요소 수를 지정하는 값입니다. PoolType 매개 변수가 WINBIO_POOL_SYSTEM 경우 이 값을 0으로 설정합니다.

[in] DatabaseId

세션에서 사용할 데이터베이스를 지정하는 값입니다. PoolType 매개 변수가 WINBIO_POOL_PRIVATE 경우 설치된 데이터베이스의 GUID를 지정해야 합니다. PoolType 매개 변수가 WINBIO_POOL_PRIVATE 않으면 다음 공통 값 중 하나를 지정할 수 있습니다.

값 의미
WINBIO_DB_DEFAULT
 센서 풀의 각 생체 인식 단위는 기본 생체 인식 단위 구성에 지정된 기본 데이터베이스를 사용합니다. PoolType 매개 변수가 WINBIO_POOL_SYSTEM 경우 이 값을 지정해야 합니다. PoolType 매개 변수가 WINBIO_POOL_PRIVATE 경우 이 값을 사용할 수 없습니다.
WINBIO_DB_BOOTSTRAP
 Windows를 시작하기 전에 시나리오에 사용할 이 값을 지정할 수 있습니다. 일반적으로 데이터베이스는 센서 칩의 일부이거나 BIOS의 일부이며 템플릿 등록 및 삭제에만 사용할 수 있습니다.
WINBIO_DB_ONCHIP
 데이터베이스는 센서 칩에 있으며 등록 및 일치에 사용할 수 있습니다.

[out] SessionHandle

새 세션 핸들에 대한 포인터입니다. 함수가 성공하지 못하면 핸들이 0으로 설정됩니다.

반환 값

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

반환 코드 설명
E_INVALIDARG
 하나 이상의 인수에 잘못된 값이 있거나 다른 인수와 호환되지 않습니다.
E_POINTER
 SessionHandle 매개 변수의 세션 핸들 포인터는 NULL일 수 없습니다.
E_ACCESSDENIED
 Flags 매개 변수는 WINBIO_FLAG_RAW 또는 WINBIO_FLAG_MAINTENANCE 플래그를 포함하며 호출자에게 액세스 권한이 부여되지 않았습니다.
WINBIO_E_INVALID_UNIT
 UnitArray 매개 변수에 지정된 하나 이상의 생체 인식 단위 번호가 잘못되었습니다.
WINBIO_E_NOT_ACTIVE_CONSOLE
 클라이언트 애플리케이션이 원격 데스크톱 클라이언트에서 실행 중이며 시스템 풀 세션을 열려고 합니다.
WINBIO_E_SENSOR_UNAVAILABLE
 PoolType 매개 변수는 WINBIO_POOL_PRIVATE 설정되며 해당 풀에서 요청된 센서 중 하나 이상을 사용할 수 없습니다.
WINBIO_E_DISABLED
 현재 관리 정책은 Windows 생체 인식 프레임워크 API 사용을 금지합니다.

요구 사항

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

추가 정보

WinBioCloseSession