Función RxNameCacheFetchEntry (namcache.h)

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 se va a 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.

Observaciones

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 la 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 puede querer realizar alguna acción especial.

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

Requisitos

Consulte también

RxNameCacheActivateEntry

rxNameCacheCheckEntry

RxNameCacheCreateEntry

RxNameCacheExpireEntry

RxNameCacheExpireEntryWithShortName

RxNameCacheFinalize

rxNameCacheFreeEntry

RxNameCacheInitialize