RxNameCacheCreateEntry 함수(namcache.h)

아티클
02/26/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

이름 캐시 항목을 초기화할 유니코드 이름 문자열에 대한 포인터입니다.

[in] CaseInsensitive

Name 매개 변수를 비교할 때 대/소문자를 구분하지 않는 비교를 사용해야 하는지 여부를 나타내는 부울 값입니다.

반환 값

RxNameCacheCreateEntry 는 성공하면 새로 할당된 NAME_CACHE 구조체에 대한 포인터를 반환하고 할당이 실패하면 NULL 포인터를 반환합니다.

설명

네트워크 미니 리디렉터에서 RxNameCacheCreateEntry 를 호출하여 지정된 이름 문자열을 사용하여 NAME_CACHE 구조를 할당하고 초기화합니다. 그런 다음 호출자는 이름 캐시 컨텍스트의 추가 네트워크 미니 리디렉션자 요소를 초기화하고, 수명(초)과 NAME_CACHE 구조체의 Context 멤버를 설정한 다음 , RxNameCacheActivateEntry를 호출하여 이름 캐시 활성 목록에 항목을 배치할 것으로 예상됩니다.

RxNameCacheCreateEntry 는 새 NAME_CACHE 항목을 할당하기 전에 먼저 사용 가능한 경우 무료 목록에서 NAME_CACHE 항목을 다시 사용하려고 시도합니다.