RxNameCacheCreateEntry 函数（namcache.h）

项目
02/07/2025

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

指向用于初始化名称缓存条目的 Unicode 名称字符串的指针。

[in] CaseInsensitive

一个布尔值，该值指示在比较 Name 参数时是否应使用不区分大小写的比较。

返回值

RxNameCacheCreateEntry 在成功时返回指向新分配的NAME_CACHE结构的指针;如果分配失败，则返回 NULL 指针。

言论

网络微型重定向程序调用 RxNameCacheCreateEntry，以使用给定的名称字符串分配和初始化NAME_CACHE结构。预计调用方随后将初始化名称缓存上下文的任何其他网络微型重定向程序元素，设置生存期（以秒为单位）和NAME_CACHE结构的 上下文 成员，然后通过调用 RxNameCacheActivateEntry将条目置于名称缓存活动列表中。

RxNameCacheCreateEntry 将首先尝试在分配新的NAME_CACHE条目之前，在免费列表中重复使用一个NAME_CACHE条目（如果可用）。