RxNameCacheCheckEntry function (namcache.h)

RxNameCacheCheckEntry checks a name cache entry for validity. A valid entry means that the lifetime has not expired and the MRxContext parameter passes the equality check.

Syntax

RX_NC_CHECK_STATUS RxNameCacheCheckEntry(
  [in] IN PNAME_CACHE NameCache,
  [in] IN ULONG       MRxContext
);

Parameters

[in] NameCache

A pointer to the NAME_CACHE structure to check.

[in] MRxContext

A value of context supplied by the network mini-redirector for equality checking when making a valid entry check.

Return value

RxNameCacheCheckEntry returns one of the possible enumeration values defined for RX_NC_CHECK_STATUS:

Return code Description
RX_NC_SUCCESS
The check was successful and the entry is valid.
RX_NC_TIME_EXPIRED
The check failed because the lifetime has expired.
RX_NC_MRXCTX_FAIL
The check failed because MRxContext failed equality checking.

Requirements

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

See also

RxNameCacheActivateEntry

RxNameCacheCreateEntry

RxNameCacheExpireEntry

RxNameCacheExpireEntryWithShortName

RxNameCacheFetchEntry

RxNameCacheFinalize

RxNameCacheFreeEntry

RxNameCacheInitialize