RtlUpcaseUnicodeToOemN function (ntifs.h)
The RtlUpcaseUnicodeToOemN routine translates a given Unicode string into an uppercase OEM string, using the current system OEM code page.
Syntax
NTSYSAPI NTSTATUS RtlUpcaseUnicodeToOemN(
[out] PCHAR OemString,
[in] ULONG MaxBytesInOemString,
[out, optional] PULONG BytesInOemString,
[in] PCWCH UnicodeString,
[in] ULONG BytesInUnicodeString
);
Parameters
[out] OemString
Pointer to a caller-allocated buffer to receive the translated string.
[in] MaxBytesInOemString
Maximum number of bytes to be written to OemString.
[out, optional] BytesInOemString
Pointer to a caller-allocated variable that receives the number of bytes in the translated string. This parameter can be NULL.
[in] UnicodeString
Pointer to the Unicode source string to be translated.
[in] BytesInUnicodeString
Size, in bytes, of the string at UnicodeString.
Return value
RtlUnicodeToOemN returns STATUS_SUCCESS if the full string at UnicodeString was successfully translated, converted to uppercase, and returned at OemString. Otherwise, it can return STATUS_BUFFER_OVERFLOW if the destination string must be truncated to fit the given MaxBytesInOemString.
Remarks
For the return value STATUS_BUFFER_OVERFLOW, the truncated string at OemString was translated without error.
For the return value STATUS_SUCCESS, the value at BytesInOemString, if any, indicates the length of the returned string, rather than the given MaxBytesInOemString.
This routine does not modify the source string. It returns a null-terminated OEM string if the given BytesInUnicodeString included a NULL terminator and if the given MaxBytesInOemString did not cause truncation.
For information about other string-handling routines, see Run-Time Library (RTL) Routines.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Universal |
| Header | ntifs.h (include Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |