RxNameCacheActivateEntry 函数（namcache.h）

项目
02/07/2025

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 表示保持当前值不变。如果想要保留原始 MRxContext，则值 0 用于重新激活。

返回值

没有

言论

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

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