Función RxNameCacheActivateEntry (namcache.h)

Artículo
08/07/2023

RxNameCacheActivateEntry toma una entrada de caché de nombres y actualiza la hora de expiración y el contexto del minidirector de red. A continuación, coloca la entrada de caché de nombres en la lista activa.

Sintaxis

void RxNameCacheActivateEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PNAME_CACHE         NameCache,
  [in] IN ULONG               LifeTime,
  [in] IN ULONG               MRxContext
);

Parámetros

[in] NameCacheCtl

Puntero a la estructura NAME_CACHE_CONTROL en la que se va a activar la entrada.

[in] NameCache

Puntero a la estructura NAME_CACHE que se va a activar.

[in] LifeTime

Valor que indica la duración válida en segundos de la entrada de caché. Un valor de 0 significa dejar el valor actual sin cambios. Se usa un valor de 0 para las reactivaciones después de una coincidencia en la que desea conservar la duración original.

[in] MRxContext

Valor de contexto proporcionado por el minidirector de red para comprobar la igualdad al realizar una comprobación de entrada válida. Un valor de MRxContext de 0 significa dejar el valor actual sin cambios. Se usa un valor de 0 para las reactivaciones después de una coincidencia en la que desea conservar el MRxContext original.

Valor devuelto

None

Observaciones

Normalmente, se llama a la rutina RxNameCacheActivateEntry después de que un minidirector de red llame 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, como Lifetime (en segundos) y MRxContext y, a continuación, coloque la entrada en la lista activa de caché de nombres llamando a RxNameCacheActivateEntry.

La rutina RxNameCacheActivateEntry supone que la entrada de caché de nombres no está en la lista gratuita o activa.