RxNameCacheFetchEntry 函数（namcache.h）

RxNameCacheFetchEntry 查找具有指定名称字符串的匹配项NAME_CACHE。

语法

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

[in] NameCacheCtl

指向要扫描的NAME_CACHE_CONTROL结构的指针。

[in] Name

指向包含要匹配的名称的 Unicode 字符串的指针。

RxNameCacheFetchEntry 返回指向匹配NAME_CACHE结构的指针（如果找到匹配项）;如果匹配失败，NULL。

RxNameCacheFetchEntry 查找指定名称参数的名称缓存活动列表中的匹配项。如果找到该名称，则会从名称缓存活动列表中删除该条目，并返回指向NAME_CACHE结构的指针。否则，将返回 NULL 。

NAME_CACHE项已从活动列表中删除，以避免另一个尝试更新同一条目的线程可能出现的问题，或者发现它已过期，并将其置于免费列表中。可以通过不同的线程获取具有相同名称的多个条目，但最终它们将过期。

如果找到匹配的NAME_CACHE条目，则不会进行过期检查。调用方必须检查到期时间，因为它可能需要采取一些特殊作。

作为扫描名称缓存活动列表的副作用，任何已过期的不匹配条目都放在免费列表中。获取名称缓存锁以保护此作。