Función RxNameCacheCreateEntry (namcache.h)

Artículo
05/23/2024

RxNameCacheCreateEntry asigna e inicializa una estructura de NAME_CACHE con la cadena de nombre especificada.

Sintaxis

PNAME_CACHE RxNameCacheCreateEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PUNICODE_STRING     Name,
  [in] IN BOOLEAN             CaseInsensitive
);

Parámetros

[in] NameCacheCtl

Puntero a la estructura NAME_CACHE_CONTROL desde la que se va a asignar la entrada.

[in] Name

Puntero a la cadena de nombre Unicode con la que inicializar la entrada de caché de nombres.

[in] CaseInsensitive

Valor booleano que indica si se deben usar comparaciones que no distinguen mayúsculas de minúsculas al comparar el parámetro Name .

Valor devuelto

RxNameCacheCreateEntry devuelve un puntero a la estructura de NAME_CACHE recién asignada si se ejecuta correctamente o un puntero NULL si se produce un error en la asignación.

Comentarios

Un minidirector de red llama a RxNameCacheCreateEntry para asignar e inicializar una estructura de NAME_CACHE con la cadena de nombre especificada. Se espera que el autor de la llamada inicialice los elementos de minidirector de red adicionales del contexto de caché de nombres, establezca la duración (en segundos) y el miembro Context de la estructura NAME_CACHE y, a continuación, coloque la entrada en la lista activa de caché de nombres llamando a RxNameCacheActivateEntry.

RxNameCacheCreateEntry intentará primero reutilizar una entrada de NAME_CACHE en la lista gratuita, si hay alguna disponible, antes de asignar una nueva entrada de NAME_CACHE.