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

Статья
02/26/2024

RxNameCacheFetchEntry ищет совпадение с указанной строкой имени для записи NAME_CACHE.

Синтаксис

PNAME_CACHE RxNameCacheFetchEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PUNICODE_STRING     Name
);

Параметры

[in] NameCacheCtl

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

[in] Name

Указатель на строку Юникода, содержащую имя для сопоставления.

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

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

RxNameCacheFetchEntry ищет совпадение в списке активных кэша имен для указанного параметра Name . Если имя найдено, запись удаляется из списка активных кэша имен и возвращается указатель на структуру NAME_CACHE. В противном случае возвращается значение NULL .

Запись NAME_CACHE удаляется из активного списка, чтобы избежать возможных проблем с другим потоком, который пытается обновить ту же запись или наблюдает за тем, что срок ее действия истек, и помещает ее в свободный список. В разных потоках можно получить несколько записей с одинаковыми именами, но в конечном итоге срок их действия истекает.

Если найдена соответствующая запись NAME_CACHE, проверка для истечения срока действия не выполняется. Вызывающий объект должен проверка для истечения срока действия, так как ему может потребоваться выполнить некоторые специальные действия.

В качестве эффекта в стороне при сканировании активного списка кэша имен все несовпадения записей, срок действия которых истек, помещаются в свободный список. Для защиты этой операции создается блокировка кэша имен.

Требования

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