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

Статья
08/07/2023

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.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	namcache.h (включая Namcache.h)
IRQL	<= APC_LEVEL