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 参数的名称缓存活动列表中查找匹配项。如果找到该名称，则会从名称缓存活动列表中删除该条目，并返回指向NAME_CACHE结构的指针。否则，返回 NULL 。

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

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

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