RtlUnicodeToMultiByteSize 함수(ntifs.h)

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

구문

NTSYSAPI NTSTATUS RtlUnicodeToMultiByteSize(
  [out] PULONG BytesInMultiByteString,
  [in]  PCWCH  UnicodeString,
  [in]  ULONG  BytesInUnicodeString
);

매개 변수

[out] BytesInMultiByteString

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

[in] UnicodeString

멀티바이트 길이를 계산할 유니코드 문자열에 대한 포인터입니다.

[in] BytesInUnicodeString

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

반환 값

RtlUnicodeToMultiByteSize 는 STATUS_SUCCESS 반환합니다.

설명

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

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

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

요구 사항

추가 정보

RtlMultiByteToUnicodeSize

RtlUnicodeToMultiByteN

RtlUpcaseUnicodeToMultiByteN