RtlUnicodeToMultiByteN 함수(ntifs.h)
RtlUnicodeToMultiByteN 루틴은 현재 시스템 ANSI 코드 페이지(ACP)를 사용하여 지정된 유니코드 문자열을 새 문자열로 변환합니다. 변환된 문자열이 반드시 멀티바이트 문자 집합에서 생성된 것은 아닙니다.
통사론
NTSYSAPI NTSTATUS RtlUnicodeToMultiByteN(
[out] PCHAR MultiByteString,
[in] ULONG MaxBytesInMultiByteString,
[out, optional] PULONG BytesInMultiByteString,
[in] PCWCH UnicodeString,
[in] ULONG BytesInUnicodeString
);
매개 변수
[out] MultiByteString
변환된 문자열을 수신하기 위해 호출자가 할당한 버퍼에 대한 포인터입니다. MultiByteString 버퍼는 UnicodeString 버퍼와 겹치지 않아야 합니다.
[in] MaxBytesInMultiByteString
MultiByteString쓸 최대 바이트 수입니다. 이 값으로 인해 번역된 문자열이 잘리면 rtlUnicodeToMultiByteN 오류 상태가 반환되지 않습니다.
[out, optional] BytesInMultiByteString
변환된 문자열의 길이(바이트)를 수신하는 호출자 할당 변수에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL 수 있습니다.
[in] UnicodeString
번역할 유니코드 소스 문자열에 대한 포인터입니다.
[in] BytesInUnicodeString
UnicodeString문자열의 크기(바이트)입니다.
반환 값
RtlUnicodeToMultiByteN STATUS_SUCCESS 반환합니다.
발언
RtlUnicodeToMultiByteN 시스템 부팅 시 설치된 현재 시스템 ANSI 코드 페이지를 사용하여 지정된 유니코드 문자열을 변환합니다.
BytesInMultiByteString 선택 사항이며 NULL 수 있지만 수신된 길이를 사용하여 변환이 성공했는지 여부를 확인할 수 있으므로 호출자는 스토리지를 제공해야 합니다.
이 루틴은 원본 문자열을 수정하지 않습니다. 지정된 BytesInUnicodeString NULL 종결자를 포함하고 지정된 MaxBytesInMultiByteString 잘림을 일으키지 않은 경우 null로 끝나는 멀티바이트 문자열을 반환합니다.
RtlUnicodeToMultiByteSize마찬가지로 RtlUnicodeToMultiByteN 시스템 부팅 시 설치된 현재 시스템 ANSI 코드 페이지에 매핑된 미리 컴파일된 유니코드 문자만 지원합니다.
다른 문자열 처리 루틴에 대한 자세한 내용은 RTL(Run-Time 라이브러리) 루틴참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 헤더 | ntifs.h(Fltkernel.h, Ntifs.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |