RxNameCacheFetchEntry 함수(namcache.h)

아티클
02/26/2024

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 항목을 찾을 경우 만료에 대한 검사 없습니다. 호출자는 몇 가지 특별한 작업을 수행할 수 있으므로 만료를 검사 합니다.

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