RxNameCacheFreeEntry function (namcache.h)

RxNameCacheFreeEntry releases the storage for a NAME_CACHE entry and decrements the count of the NAME_CACHE cache entries associated with a NAME_CACHE_CONTROL structure.

Syntax

void RxNameCacheFreeEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PNAME_CACHE         NameCache
);

Parameters

[in] NameCacheCtl

A pointer to the NAME_CACHE_CONTROL structure for the name cache.

[in] NameCache

A pointer to the NAME_CACHE structure to free.

Return value

None

Remarks

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

The RxNameCacheFreeEntry routine frees memory allocated for the name buffer if the name buffer for this name cache entry is not NULL. This routine will then free memory used for the NAME_CACHE entry. Then, the count of name cache entries on NameCacheCtl is decremented.

Requirements

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

See also

RxNameCacheActivateEntry

RxNameCacheCheckEntry

RxNameCacheCreateEntry

RxNameCacheExpireEntry

RxNameCacheExpireEntryWithShortName

RxNameCacheFetchEntry

RxNameCacheFinalize

RxNameCacheInitialize