다음을 통해 공유


RxNameCacheCreateEntry 함수(namcache.h)

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 항목을 다시 사용하려고 시도합니다.

요구 사항

요구
대상 플랫폼 바탕 화면
헤더 namcache.h(Namcache.h 포함)
IRQL <= APC_LEVEL

참고 항목

RxNameCacheActivateEntry

RxNameCacheCheckEntry

RxNameCacheExpireEntry

RxNameCacheExpireEntryWithShortName

RxNameCacheFetchEntry

RxNameCacheFinalize

RxNameCacheFreeEntry

RxNameCacheInitialize