RxNameCacheFetchEntry 函式 (namcache.h)

RxNameCacheFetchEntry 會尋找具有指定名稱字串的相符專案NAME_CACHE。

語法

PNAME_CACHE RxNameCacheFetchEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PUNICODE_STRING     Name
);

[in] NameCacheCtl

要掃描之NAME_CACHE_CONTROL結構的指標。

[in] Name

Unicode 字串的指標，其中包含要比對的名稱。

如果找到相符專案，RxNameCacheFetchEntry 會傳回相符NAME_CACHE結構的指標，如果相符項目失敗，則傳回 NULL。

RxNameCacheFetchEntry 會在指定 Name 參數的名稱快取使用中列表中尋找相符專案。如果找到名稱，則會從名稱快取使用中清單移除專案，並傳回NAME_CACHE結構的指標。否則會傳回 NULL 。

NAME_CACHE專案會從使用中清單中移除，以避免嘗試更新相同專案的另一個線程發生可能的問題，或觀察到該專案已過期，並將它放在免費清單上。可以透過不同的線程取得具有相同名稱的多個專案，但最終會過期。

如果找到相符NAME_CACHE專案，則不會檢查到期日。呼叫端必須檢查到期日，因為它可能想要採取一些特殊動作。

另一個效果是掃描名稱快取使用中清單時，任何已過期的非相符專案會放在免費清單上。系統會取得名稱快取鎖定來保護這項作業。