FindOrCreateNameCache 関数 (filehc.h)
名前キャッシュを検索または作成します。
構文
FILEHC_EXPORT PNAME_CACHE_CONTEXT FindOrCreateNameCache(
[in] LPSTR lpstrName,
[in] CACHE_KEY_COMPARE pfnKeyCompare,
[in] CACHE_KEY_HASH pfnKeyHash,
[in] CACHE_DESTROY_CALLBACK pfnKeyDestroy,
[in] CACHE_DESTROY_CALLBACK pfnDataDestroy
);
パラメーター
[in] lpstrName
作成する名前キャッシュの名前。 このパラメーターでは大文字と小文字が区別され、 NULL に設定することはできません。
[in] pfnKeyCompare
キーを比較するためにクライアントによって提供される関数へのポインター。 このパラメーターを NULL にすることはできません。
[in] pfnKeyHash
キーのハッシュ値を計算するためにクライアントによって提供される関数へのポインター。
メモ キャッシュは、ユーザーがハッシュ関数を提供しない場合にのみ提供されます。 ただし、内部提供のハッシュ関数は、通常の文字列と思われる項目にのみ最適です。
[in] pfnKeyDestroy
CACHE_DESTROY_CALLBACK関数へのポインター。 このパラメーターは、NULL でもかまいません。
[in] pfnDataDestroy
CACHE_DESTROY_CALLBACK関数へのポインター。 このパラメーターは、NULL でもかまいません。
戻り値
名前キャッシュを表す NAME_CACHE_CONTEXT 構造体を返します。
解説
名前キャッシュは参照カウントされます。 この関数が同じ名前で 2 回呼び出されると、参照が既存の名前キャッシュに追加されます。
NAME_CACHE_CONTEXT構造体には、クライアントに役立つフィールドは含まれていませんが、すべての名前キャッシュ関数に渡す必要があります。
要件
| 対象プラットフォーム | Windows |
| ヘッダー | filehc.h |
| Library | Fcachdll.lib |
| [DLL] | Fcachdll.dll |