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 で終わる Unicode 文字列へのポインター。

[in] ConnectString

データベースの NULL で終わる Unicode 接続文字列へのポインター。

戻り値

関数が成功した場合は、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