피드백

RxNameCacheFetchEntry 함수(namcache.h)

  • 아티클
  • 읽는 데 2분 걸림

RxNameCacheFetchEntry 는 NAME_CACHE 항목에 대해 지정된 이름 문자열이 있는 일치 항목을 찾습니다.

구문

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

매개 변수

[in] NameCacheCtl

검색할 NAME_CACHE_CONTROL 구조체에 대한 포인터입니다.

[in] Name

일치시킬 이름을 포함하는 유니코드 문자열에 대한 포인터입니다.

반환 값

일치 항목이 발견되면 RxNameCacheFetchEntry가 일치하는 NAME_CACHE 구조체에 대한 포인터를 반환하고, 일치 항목이 실패하면 NULL을 반환합니다.

설명

RxNameCacheFetchEntry 는 지정된 Name 매개 변수에 대한 이름 캐시 활성 목록에서 일치 항목을 찾습니다. 이름이 발견되면 항목이 이름 캐시 활성 목록에서 제거되고 NAME_CACHE 구조체에 대한 포인터가 반환됩니다. 그렇지 않으면 NULL 이 반환됩니다.

NAME_CACHE 항목이 활성 목록에서 제거되어 동일한 항목을 업데이트하려는 다른 스레드에서 발생할 수 있는 문제를 방지하거나 만료된 것을 관찰하여 사용 가능한 목록에 추가합니다. 다른 스레드에서 동일한 이름의 여러 항목을 가져올 수 있지만 결국 만료됩니다.

일치하는 NAME_CACHE 항목이 있으면 만료를 확인하지 않습니다. 호출자는 몇 가지 특별한 작업을 수행할 수 있으므로 만료를 확인해야 합니다.

이름 캐시 활성 목록을 검사할 때 제쳐두고 적용되므로 만료된 일치하지 않는 항목은 모두 무료 목록에 배치됩니다. 이 작업을 보호하기 위해 이름 캐시 잠금을 획득합니다.

요구 사항

   
대상 플랫폼 데스크톱
헤더 namcache.h(Namcache.h 포함)
IRQL <= APC_LEVEL

참조

RxNameCacheActivateEntry

RxNameCacheCheckEntry

RxNameCacheCreateEntry

RxNameCacheExpireEntry

RxNameCacheExpireEntryWithShortName

RxNameCacheFinalize

RxNameCacheFreeEntry

RxNameCacheInitialize