RtlInsertUnicodePrefix 함수(ntifs.h)

RtlInsertUnicodePrefix 루틴은 유니코드 접두사 테이블에 새 요소를 삽입합니다.

구문

NTSYSAPI BOOLEAN RtlInsertUnicodePrefix(
  [in]  PUNICODE_PREFIX_TABLE            PrefixTable,
  [in]  __drv_aliasesMem PUNICODE_STRING Prefix,
  [out] PUNICODE_PREFIX_TABLE_ENTRY      PrefixTableEntry
);

매개 변수

[in] PrefixTable

접두사 테이블에 대한 포인터입니다. RtlInitializeUnicodePrefix를 호출하여 테이블을 초기화해야 합니다.

[in] Prefix

PrefixTableEntry에서 요소와 함께 삽입할 이름 문자열에 대한 포인터입니다.

[out] PrefixTableEntry

새 접두사에 대해 요소를 삽입하려면 최소한 sizeof(UNICODE_PREFIX_TABLE_ENTRY)여야 하는 호출자 할당 스토리지에 대한 포인터입니다. RtlInsertUnicodePrefix 는 호출자가 불투명한 것으로 간주해야 하는 이 요소를 초기화합니다.

반환 값

RtlInsertUnicodePrefix 는 새 요소가 접두사 테이블에 삽입된 경우 TRUE 를 반환하거나 접두사 테이블에 중복 요소가 이미 있는 경우 FALSE 를 반환합니다.

설명

테이블의 각 접두사 항목은 파일 시스템 볼륨의 루트 디렉터리를 기준으로 하는 경로 이름입니다. 올바른 형식이 되려면 접두사는 단일 백슬래시()로 시작해야 합니다.

새 요소를 삽입한 후 RtlInsertUnicodePrefix 는 접두사 테이블의 플레이 트리의 균형을 다시 조정합니다.

파일 시스템은 다른 Rtl을 사용하기 전에 접두사 테이블을 초기화하려면 RtlInitializeUnicodePrefix 를 호출해야 합니다 . UnicodePrefix 루틴입니다. 초기화된 접두사 테이블 구조는 불투명한 것으로 간주되어야 합니다.

Rtl의 호출자 입니다. UnicodePrefix 루틴은 접두사 테이블에 대한 액세스를 동기화하는 역할을 합니다. 빠른 뮤텍스는 이 목적을 위해 사용할 수 있는 가장 효율적인 동기화 메커니즘입니다.

다른 문자열 처리 루틴에 대한 자세한 내용은 RTL(런타임 라이브러리) 루틴을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP
지원되는 최소 서버	Windows Server 2003
대상 플랫폼	유니버설
헤더	ntifs.h(Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL

추가 정보

RtlFindUnicodePrefix

RtlInitializeUnicodePrefix

RtlNextUnicodePrefix

RtlRemoveUnicodePrefix

UNICODE_STRING