Поделиться через

Функция 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
Header filehc.h
Библиотека Fcachdll.lib
DLL Fcachdll.dll

См. также раздел

CACHE_DESTROY_CALLBACK

NAME_CACHE_CONTEXT