RtlMultiByteToUnicodeSize 함수(ntifs.h)

RtlMultiByteToUnicodeSize 루틴은 지정된 소스 문자열에 대한 유니코드 변환을 저장하는 데 필요한 바이트 수를 결정합니다. 번역은 현재 시스템 ANSI 코드 페이지(ACP)를 사용하는 것으로 간주됩니다. 원본 문자열이 반드시 멀티바이트 문자 집합에서 온 것은 아닙니다.

구문

NTSYSAPI NTSTATUS RtlMultiByteToUnicodeSize(
  [out] PULONG     BytesInUnicodeString,
  [in]  const CHAR *MultiByteString,
  [in]  ULONG      BytesInMultiByteString
);

매개 변수

[out] BytesInUnicodeString

변환된 문자열을 저장하는 데 필요한 바이트 수를 수신하는 호출자 할당 변수에 대한 포인터입니다.

[in] MultiByteString

유니코드 길이를 계산할 원본 문자열에 대한 포인터입니다.

[in] BytesInMultiByteString

원본 문자열의 길이(바이트)입니다.

반환 값

RtlMultiByteToUnicodeSize 는 STATUS_SUCCESS 반환합니다.

설명

RtlMultiByteToUnicodeSize를 호출하여 멀티바이트 문자열을 RtlMultiByteToUnicodeN을 사용하여 유니코드로 변환하기 전에 MaxBytesInUnicodeString에 지정할 값 또는 할당할 메모리 양을 결정할 수 있습니다. 반환된 값에는 유니코드 문자열에 대한 NULL 종결자에 대한 공간이 포함되지 않습니다.

RtlMultiByteToUnicodeN과 마찬가지로 RtlMultiByteToUnicodeSize는 시스템 부팅 시 설치된 현재 시스템 ANSI 코드 페이지에 매핑된 미리 컴파일된 유니코드 문자만 지원합니다.

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

요구 사항

요구 사항	값
대상 플랫폼	유니버설
헤더	ntifs.h(Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL

추가 정보

RtlMultiByteToUnicodeN

RtlUnicodeToMultiByteSize