RxNameCacheExpireEntryWithShortName function (namcache.h)

Article
02/22/2024

RxNameCacheExpireEntryWithShortName expires all of the name cache entries whose name prefix matches the given short file name.

Syntax

void RxNameCacheExpireEntryWithShortName(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PUNICODE_STRING     Name
);

Parameters

[in] NameCacheCtl

A pointer to the NAME_CACHE_CONTROL structure to scan.

[in] Name

A pointer to the Unicode string that contains the name prefix to scan for name cache entry matches to expire.

Return value

None

Remarks

The RxNameCacheExpireEntryWithShortName routine scans the active list and inserts any matching NAME_CACHE entries at the head of the free list. The CaseInsensitive member of the NAME_CACHE entry is used to determine whether the scan should ignore case sensitivity when matching the Name parameter.

Because the active list is scanned, the RxNameCacheExpireEntryWithShortName routine puts any non-matching entries that have expired on the free list. A Name value of zero length will match all entries and insert the entries on the free list.

Requirements

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