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 结构。

备注

对名称缓存进行引用计数。 如果用同一名称调用此函数两次,则会向现有名称缓存添加引用。

NAME_CACHE_CONTEXT 结构不包含任何对客户端有用的字段,但必须将其传递回所有名称缓存函数。

要求

   
目标平台 Windows
标头 filehc.h
Library Fcachdll.lib
DLL Fcachdll.dll

请参阅

CACHE_DESTROY_CALLBACK

NAME_CACHE_CONTEXT