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