RxNameCacheActivateEntry 函式（namcache.h）

發行項
02/07/2025

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 例程假設名稱快取專案不在免費或作用中清單中。