RxNameCacheActivateEntry function (namcache.h)

Article
03/15/2022

RxNameCacheActivateEntry takes a name cache entry and updates the expiration time and the network mini-redirector context. It then puts the name cache entry on the active list.

Syntax

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

Parameters

[in] NameCacheCtl

A pointer to the NAME_CACHE_CONTROL structure on which to activate the entry.

[in] NameCache

A pointer to the NAME_CACHE structure to activate.

[in] LifeTime

A value that indicates the valid lifetime in seconds of the cache entry. A value of 0 means to leave the current value unchanged. A value of 0 is used for reactivations after a match where you want the original lifetime preserved.

[in] MRxContext

A value of context supplied by the network mini-redirector for equality checking when making a valid entry check. An MRxContext value of 0 means to leave the current value unchanged. A value of 0 is used for reactivations after a match where you want the original MRxContext preserved.

Return value

None

Remarks

The RxNameCacheActivateEntry routine is normally called after a network mini-redirector calls RxNameCacheCreateEntry to allocate and initialize a NAME_CACHE structure with the given name string. It is expected that the caller will then initialize any additional network mini-redirector elements of the name cache context, such as Lifetime (in seconds) and MRxContext, and then put the entry on the name cache active list by calling RxNameCacheActivateEntry.

The RxNameCacheActivateEntry routine assumes that the name cache entry is not on either the free or active list.

Requirements

Requirement	Value
Target Platform	Desktop
Header	namcache.h (include Namcache.h)
IRQL	<= APC_LEVEL