Функция RxNameCacheActivateEntry (namcache.h)

Статья
08/07/2023

RxNameCacheActivateEntry принимает запись кэша имен и обновляет время окончания срока действия и контекст мини-перенаправления сети. Затем он помещает запись кэша имен в активный список.

Синтаксис

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

Параметры

[in] NameCacheCtl

Указатель на структуру NAME_CACHE_CONTROL, в которой активируется запись.

[in] NameCache

Указатель на структуру NAME_CACHE для активации.

[in] LifeTime

Значение типа , указывающее допустимое время существования записи кэша в секундах. Значение 0 означает, что текущее значение остается без изменений. Значение 0 используется для повторной активации после совпадения, где необходимо сохранить исходное время существования.

[in] MRxContext

Значение контекста, предоставляемое мини-перенаправлением сети для проверки на равенство при создании допустимой записи проверка. Значение MRxContext , равное 0, означает, что текущее значение остается без изменений. Значение 0 используется для повторной активации после совпадения, где требуется сохранить исходный MRxContext .

Возвращаемое значение

None

Remarks

Подпрограмма RxNameCacheActivateEntry обычно вызывается после того, как сетевой мини-перенаправитель вызывает RxNameCacheCreateEntry для выделения и инициализации структуры NAME_CACHE с заданной строкой имени. Ожидается, что вызывающий объект инициализирует все дополнительные элементы мини-перенаправления сети контекста кэша имен, такие как Время существования (в секундах) и MRxContext, а затем поместит запись в активный список кэша имен, вызвав RxNameCacheActivateEntry.

Подпрограмма RxNameCacheActivateEntry предполагает, что запись кэша имен отсутствует в списке "Бесплатный" или "Активный".

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	namcache.h (включая Namcache.h)
IRQL	<= APC_LEVEL