PIBIO_STORAGE_OPEN_DATABASE_FN callback function (winbio_adapter.h)

Called by the Windows Biometric Framework to open a database.

Syntax

PIBIO_STORAGE_OPEN_DATABASE_FN PibioStorageOpenDatabaseFn;

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

Parameters

[in, out] Pipeline

Pointer to the WINBIO_PIPELINE structure associated with the biometric unit performing the operation.

[in] DatabaseId

Pointer to a GUID that uniquely identifies the database. This is the same GUID used to register the database in the registry.

[in] FilePath

Pointer to a NULL-terminated Unicode string that contains the fully qualified file path for the database.

[in] ConnectString

Pointer to a NULL-terminated Unicode connection string for the database.

Return value

If the function succeeds, it returns S_OK. If the function fails, it must return one of the following HRESULT values to indicate the error.

Return code	Description
E_POINTER	A mandatory pointer argument is NULL.
WINBIO_E_DATABASE_CANT_CREATE	The database cannot be created.
WINBIO_E_DATABASE_CANT_FIND	The specified database cannot be found.
WINBIO_E_DATABASE_LOCKED	The database is currently locked by another application and cannot be opened.
WINBIO_E_DATABASE_CANT_OPEN	An unspecified problem has caused the request to fail.
WINBIO_E_INVALID_DEVICE_STATE	The StorageContext member of the pipeline object is NULL.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Target Platform	Windows
Header	winbio_adapter.h (include Winbio_adapter.h)

See also

Plug-in Functions

StorageAdapterCloseDatabase

StorageAdapterCreateDatabase

StorageAdapterEraseDatabase