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專案，則不會檢查到期日。 呼叫端必須檢查到期日，因為它可能想要採取一些特殊動作。
當掃描名稱快取使用中清單時，任何已過期的非相符專案會放在免費清單中。 取得名稱快取鎖定以保護這項作業。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 桌面 |
| 標頭 | namcache.h （include Namcache.h） |
| IRQL | <= APC_LEVEL |