PIBIO_STORAGE_OPEN_DATABASE_FN 콜백 함수(winbio_adapter.h)

Windows 생체 인식 프레임워크에서 데이터베이스를 열기 위해 호출됩니다.

구문

PIBIO_STORAGE_OPEN_DATABASE_FN PibioStorageOpenDatabaseFn;

HRESULT PibioStorageOpenDatabaseFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [in]      PWINBIO_UUID DatabaseId,
  [in]      LPCWSTR FilePath,
  [in]      LPCWSTR ConnectString
)
{...}

매개 변수

[in, out] Pipeline

작업을 수행하는 생체 인식 단위와 연결된 WINBIO_PIPELINE 구조체에 대한 포인터입니다.

[in] DatabaseId

데이터베이스를 고유하게 식별하는 GUID에 대한 포인터입니다. 레지스트리에 데이터베이스를 등록하는 데 사용되는 것과 동일한 GUID입니다.

[in] FilePath

데이터베이스에 대한 정규화된 파일 경로를 포함하는 NULL로 끝나는 유니코드 문자열에 대한 포인터입니다.

[in] ConnectString

데이터베이스에 대한 NULL 종료 유니코드 연결 문자열 대한 포인터입니다.

반환 값

함수가 성공하면 S_OK를 반환합니다. 함수가 실패하면 다음 HRESULT 값 중 하나를 반환하여 오류를 나타내야 합니다.

반환 코드	설명
E_POINTER	필수 포인터 인수는 NULL입니다.
WINBIO_E_DATABASE_CANT_CREATE	데이터베이스를 만들 수 없습니다.
WINBIO_E_DATABASE_CANT_FIND	지정된 데이터베이스를 찾을 수 없습니다.
WINBIO_E_DATABASE_LOCKED	데이터베이스는 현재 다른 애플리케이션에 의해 잠겨 있으며 열 수 없습니다.
WINBIO_E_DATABASE_CANT_OPEN	지정되지 않은 문제로 인해 요청이 실패했습니다.
WINBIO_E_INVALID_DEVICE_STATE	파이프라인 개체의 StorageContext 멤버가 NULL입니다.

요구 사항

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

추가 정보

플러그 인 함수

StorageAdapterCloseDatabase

StorageAdapterCreateDatabase

StorageAdapterEraseDatabase