RxNameCacheCreateEntry 函数 (namcache.h)

项目
02/26/2024

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结构的 Context 成员设置生存期 (秒，然后通过调用 RxNameCacheActivateEntry 将条目置于名称缓存活动列表中。

RxNameCacheCreateEntry 将首先尝试重用免费列表中的NAME_CACHE条目（如果可用），然后再分配新的NAME_CACHE条目。