Función RxNameCacheActivateEntry (namcache.h)

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 sin cambios el valor actual. 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 MRxContext valor de 0 significa dejar sin cambios el valor actual. Se usa un valor de 0 para las reactivaciones después de una coincidencia en la que desea que se conserve el MRxContext original.

Valor devuelto

Ninguno

Observaciones

Normalmente, se llama a la rutina RxNameCacheActivateEnt ry después de llamar a un minidirector de red 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 duración (en segundos) y MRxContexty, a continuación, coloque la entrada en la lista activa de caché de nombres llamando a RxNameCacheActivateEntry.

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

Requisitos

Consulte también

rxNameCacheCheckEntry

RxNameCacheCreateEntry

RxNameCacheExpireEntry

RxNameCacheExpireEntryWithShortName

RxNameCacheFetchEntry

RxNameCacheFinalize

rxNameCacheFreeEntry

RxNameCacheInitialize