RxNameCacheCreateEntry function (namcache.h)
RxNameCacheCreateEntry allocates and initializes a NAME_CACHE structure with the given name string.
Syntax
PNAME_CACHE RxNameCacheCreateEntry(
[in] IN PNAME_CACHE_CONTROL NameCacheCtl,
[in] IN PUNICODE_STRING Name,
[in] IN BOOLEAN CaseInsensitive
);
Parameters
[in] NameCacheCtl
A pointer to the NAME_CACHE_CONTROL structure from which to allocate the entry.
[in] Name
A pointer to the Unicode name string with which to initialize the name cache entry.
[in] CaseInsensitive
A Boolean value that indicates if case insensitive comparisons should be used when comparing the Name parameter.
Return value
RxNameCacheCreateEntry returns a pointer to the newly allocated NAME_CACHE structure on success or a NULL pointer if the allocation fails.
Remarks
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, set the lifetime (in seconds) and the Context member of the NAME_CACHE structure and then put the entry on the name cache active list by calling RxNameCacheActivateEntry.
RxNameCacheCreateEntry will first attempt to reuse a NAME_CACHE entry on the free list, if one is available, before allocating a new NAME_CACHE entry.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Desktop |
| Header | namcache.h (include Namcache.h) |
| IRQL | <= APC_LEVEL |