RxNameCacheCreateEntry 函式（namcache.h）

發行項
02/07/2025

RxNameCacheCreateEntry 配置並初始化具有指定名稱字串的NAME_CACHE結構。

語法

PNAME_CACHE RxNameCacheCreateEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PUNICODE_STRING     Name,
  [in] IN BOOLEAN             CaseInsensitive
);

參數

[in] NameCacheCtl

要從中配置專案之NAME_CACHE_CONTROL結構的指標。

[in] Name

Unicode 名稱字串的指標，用來初始化名稱快取專案。

[in] CaseInsensitive

布爾值，指出比較 Name 參數時，是否應該使用不區分大小寫的比較。

傳回值

RxNameCacheCreateEntry 在成功時傳回新配置的NAME_CACHE結構的指標，如果配置失敗，則傳回 NULL 指標。

言論

網路迷你重新導向器會呼叫 RxNameCacheCreateEntry，以指定的名稱字串配置和初始化NAME_CACHE結構。預計呼叫端接著會初始化名稱快取內容的任何其他網路迷你重新導向器元素、設定存留期（以秒為單位），以及NAME_CACHE結構 Context 成員，然後藉由呼叫 RxNameCacheActivateEntry，將專案放在名稱快取使用中清單中。

RxNameCacheCreateEntry 會先嘗試在免費清單中重複使用NAME_CACHE專案，如果有的話，再配置新的NAME_CACHE專案。