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

関連項目

CACHE_DESTROY_CALLBACK

NAME_CACHE_CONTEXT