ホーム › Devices.BiometricFramework › PIBIO_ENGINE_REFRESH_CACHE_FN

PIBIO_ENGINE_REFRESH_CACHE_FN

コールバック

シグネチャ

HRESULT PIBIO_ENGINE_REFRESH_CACHE_FN(
    WINBIO_PIPELINE* Pipeline
);

パラメーター

フィールド	型	説明
Pipeline	WINBIO_PIPELINE*	操作を実行するバイオメトリックユニットに関連付けられた WINBIO_PIPELINE 構造体へのポインターです。

公式ドキュメント

Windows Biometric Framework によって呼び出され、メモリ内に保持している可能性があるキャッシュ済みテンプレートを破棄すべきであることを Engine Adapter に通知します。

戻り値

この関数は、次のいずれかの HRESULT 値を返します。

戻り値	説明
E_POINTER	Pipeline パラメーターを NULL にすることはできません。
S_OK	それ以外のすべての場合は、この値が返されます。

解説(Remarks)

(パフォーマンス上の理由などで) テンプレートのプライベートなメモリ内キャッシュを保持する Engine Adapter は、このメソッドが呼び出されたときにキャッシュの内容を破棄する必要があります。この呼び出しは、キャッシュの内容がすでに有効ではないことを示します。Engine Adapter のキャッシュポリシーによっては、このタイミングでテンプレートデータベースからキャッシュを再読み込みすることもできます。

バイオメトリックサービスは、次の状況でこのメソッドを呼び出します。

StorageAdapterAttach ルーチンがテンプレートデータベースへの接続を正常に開いたときに 1 回。
さらに、テンプレートデータベースの状態を変更する操作を実行した後にも呼び出されます。
- データベースへの新しいテンプレートの追加。
- データベースからの 1 つ以上の既存のテンプレートの削除。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)