Función RxNameCacheFetchEntry (namcache.h)

Artículo
02/26/2024

RxNameCacheFetchEntry busca una coincidencia con una cadena de nombre especificada para una entrada de NAME_CACHE.

Sintaxis

PNAME_CACHE RxNameCacheFetchEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PUNICODE_STRING     Name
);

Parámetros

[in] NameCacheCtl

Puntero a la estructura NAME_CACHE_CONTROL que se va a examinar.

[in] Name

Puntero a la cadena Unicode que contiene el nombre que debe coincidir.

Valor devuelto

RxNameCacheFetchEntry devuelve un puntero a la estructura de NAME_CACHE coincidente si se encontró una coincidencia, o NULL si se produjo un error en la coincidencia.

Comentarios

RxNameCacheFetchEntry busca una coincidencia en la lista activa de la caché de nombres para el parámetro Name especificado. Si se encuentra el nombre, se quita la entrada de la lista activa de caché de nombres y se devuelve un puntero a la estructura NAME_CACHE. De lo contrario, se devuelve NULL .

La entrada NAME_CACHE se quita de la lista activa para evitar posibles problemas con otro subproceso que intenta actualizar la misma entrada, o observando que expiró y lo coloca en la lista gratuita. Es posible obtener varias entradas con el mismo nombre por subprocesos diferentes, pero finalmente expirarán.

Si se encuentra una entrada de NAME_CACHE coincidente, no se realiza ninguna comprobación para la expiración. El autor de la llamada debe comprobar la expiración porque es posible que quiera realizar alguna acción especial.

Como efecto de reserva, ya que se examina la lista activa de caché de nombres, las entradas que no coincidan que hayan expirado se colocan en la lista gratuita. El bloqueo de caché de nombres se adquiere para proteger esta operación.