Функция 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.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | namcache.h (включая Namcache.h) |
| IRQL | <= APC_LEVEL |