RxNameCacheCreateEntry 函式 (namcache.h)

發行項
02/27/2024

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專案。