RxNameCacheFinalize function (namcache.h)

RxNameCacheFinalize releases the storage for all of the NAME_CACHE entries associated with a NAME_CACHE_CONTROL structure.

Syntax

void RxNameCacheFinalize(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl
);

Parameters

[in] NameCacheCtl

A pointer to the NAME_CACHE_CONTROL structure for the name cache.

Return value

None

Remarks

The RxNameCacheFinalize routine acquires the lock on the name cache to scan the free list and remove entries from the active list.

On checked builds, this routine causes the system to ASSERT if after releasing all of the active and free entries a reference count still remains on the name cache. This indicates a memory leak where some caller did not call RxNameCacheFreeEntry when done with an entry.

Requirements

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

See also

RxNameCacheActivateEntry

RxNameCacheCheckEntry

RxNameCacheCreateEntry

RxNameCacheExpireEntry

RxNameCacheExpireEntryWithShortName

RxNameCacheFetchEntry

RxNameCacheFreeEntry

RxNameCacheInitialize