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

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.

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

Никакой

Замечания

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

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

Требования

См. также

RxNameCacheCheckEntry

RxNameCacheCreateEntry

RxNameCacheExpireEntry

RxNameCacheExpireEntryWithShortName

RxNameCacheFetchEntry

RxNameCacheFinalize

RxNameCacheFreeEntry

RxNameCacheInitialize