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 |