RxNameCacheActivateEntry 函式 (namcache.h)

發行項
02/27/2024

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 表示讓目前的值保持不變。在您想要保留原始 MRxContext 的相符項目之後，會使用 0 的值重新啟用。

傳回值

無

備註

RxNameCacheActivateEntry 例程通常會在網路迷你重新導向器呼叫 RxNameCacheCreateEntry 之後呼叫，以指定的名稱字元串來配置和初始化NAME_CACHE結構。呼叫端接著會初始化名稱快取內容的任何其他網路迷你重新導向器元素，例如 存留期 (，以秒為單位) 和 MRxContext，然後藉由呼叫 RxNameCacheActivateEntry 將專案放在名稱快取作用中清單上。

RxNameCacheActivateEntry 例程假設名稱快取專案不在免費或作用中清單上。