RxNameCacheActivateEntry 函数 (namcache.h)

项目
02/26/2024

RxNameCacheActivateEntry 采用名称缓存条目，并更新过期时间和网络微型重定向程序上下文。然后，它将名称缓存项放在活动列表中。

语法

void RxNameCacheActivateEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PNAME_CACHE         NameCache,
  [in] IN ULONG               LifeTime,
  [in] IN ULONG               MRxContext
);

参数

[in] NameCacheCtl

指向要激活条目的NAME_CACHE_CONTROL 结构的指针。

[in] NameCache

指向要激活的NAME_CACHE结构的指针。

[in] LifeTime

一个值，该值指示缓存项的有效生存期（以秒为单位）。值为 0 表示保持当前值不变。值 0 用于在需要保留原始生存期的匹配之后重新激活。

[in] MRxContext

网络微型重定向程序提供的上下文值，用于在检查进行有效条目时进行相等性检查。 MRxContext 值为 0 表示保持当前值不变。值 0 用于在需要保留原始 MRxContext 的匹配后重新激活。

返回值

无

备注

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

RxNameCacheActivateEntry 例程假定名称缓存项不在免费列表或活动列表中。