Функция RxNameCacheCreateEntry (namcache.h)

RxNameCacheCreateEntry выделяет и инициализирует структуру NAME_CACHE с заданной строкой имени.

Синтаксис

PNAME_CACHE RxNameCacheCreateEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PUNICODE_STRING     Name,
  [in] IN BOOLEAN             CaseInsensitive
);

Параметры

[in] NameCacheCtl

Указатель на NAME_CACHE_CONTROL структуру, из которой выделяется запись.

[in] Name

Указатель на строку имени Юникода, с помощью которой инициализировать запись кэша имен.

[in] CaseInsensitive

Логическое значение, указывающее, следует ли использовать нечувствительные сравнения регистра при сравнении параметра Name.

Возвращаемое значение

RxNameCacheCreateEntry возвращает указатель на только что выделенную NAME_CACHE структуру успешного выполнения или указатель NULL, если выделение завершается ошибкой.

Замечания

Мини-перенаправление сети вызывает RxNameCacheCreateEntry для выделения и инициализации структуры NAME_CACHE с заданной строкой имени. Ожидается, что вызывающий объект будет инициализировать все дополнительные элементы мини-перенаправления сети контекста кэша имен, задать время существования (в секундах) и элемент контекста контекста структуры NAME_CACHE, а затем поместить запись в активный список кэша имен путем вызова RxNameCacheActivateEntry.

RxNameCacheCreateEntry сначала попытается повторно использовать запись NAME_CACHE в бесплатном списке, если она доступна, перед выделением новой записи NAME_CACHE.

Требования

См. также

RxNameCacheActivateEntry

RxNameCacheCheckEntry

RxNameCacheExpireEntry

RxNameCacheExpireEntryWithShortName

RxNameCacheFetchEntry

RxNameCacheFinalize

RxNameCacheFreeEntry

RxNameCacheInitialize