RtlUpcaseUnicodeToOemN 함수(ntifs.h)
RtlUpcaseUnicodeToOemN 루틴은 현재 시스템 OEM 코드 페이지를 사용하여 지정된 유니코드 문자열을 대문자 OEM 문자열로 변환합니다.
통사론
NTSYSAPI NTSTATUS RtlUpcaseUnicodeToOemN(
[out] PCHAR OemString,
[in] ULONG MaxBytesInOemString,
[out, optional] PULONG BytesInOemString,
[in] PCWCH UnicodeString,
[in] ULONG BytesInUnicodeString
);
매개 변수
[out] OemString
변환된 문자열을 수신하기 위해 호출자가 할당한 버퍼에 대한 포인터입니다.
[in] MaxBytesInOemString
OemString쓸 최대 바이트 수입니다.
[out, optional] BytesInOemString
변환된 문자열의 바이트 수를 수신하는 호출자 할당 변수에 대한 포인터입니다. 이 매개 변수는 NULL 수 있습니다.
[in] UnicodeString
번역할 유니코드 소스 문자열에 대한 포인터입니다.
[in] BytesInUnicodeString
UnicodeString문자열의 크기(바이트)입니다.
반환 값
RtlUnicodeToOemNUnicodeString 전체 문자열이 성공적으로 번역되고, 대문자로 변환되고, OemString반환되면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 지정된 MaxBytesInOemString맞게 대상 문자열을 잘라내야 하는 경우 STATUS_BUFFER_OVERFLOW 반환할 수 있습니다.
발언
STATUS_BUFFER_OVERFLOW 반환 값의 경우 OemString 잘린 문자열이 오류 없이 변환되었습니다.
STATUS_SUCCESS 반환 값의 경우 BytesInOemString값(있는 경우)은 지정된 MaxBytesInOemString아니라 반환된 문자열의 길이를 나타냅니다.
이 루틴은 원본 문자열을 수정하지 않습니다. 지정된 BytesInUnicodeString NULL 종결자를 포함하고 지정된 MaxBytesInOemString 잘림을 일으키지 않은 경우 null로 끝나는 OEM 문자열을 반환합니다.
다른 문자열 처리 루틴에 대한 자세한 내용은 RTL(Run-Time 라이브러리) 루틴참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 헤더 | ntifs.h(Ntifs.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |