RtlUpcaseUnicodeToMultiByteN function (ntifs.h)

The RtlUpcaseUnicodeToMultiByteN routine translates the specified Unicode string into a new uppercase character string, using the current system ANSI code page (ACP). The translated string is not necessarily from a multibyte character set.

Syntax

NTSYSAPI NTSTATUS RtlUpcaseUnicodeToMultiByteN(
  [out]           PCHAR  MultiByteString,
  [in]            ULONG  MaxBytesInMultiByteString,
  [out, optional] PULONG BytesInMultiByteString,
  [in]            PCWCH  UnicodeString,
  [in]            ULONG  BytesInUnicodeString
);

Parameters

[out] MultiByteString

Pointer to a caller-allocated buffer to receive the translated string.

[in] MaxBytesInMultiByteString

Maximum number of bytes to be written at MultiByteString. If this value causes the translated string to be truncated, RtlUpcaseUnicodeToMultiByteN does not return an error status.

[out, optional] BytesInMultiByteString

Pointer to a caller-allocated variable that receives the length, in bytes, of 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

RtlUpcaseUnicodeToMultiByteN returns STATUS_SUCCESS.

Remarks

RtlUpcaseUnicodeToMultiByteN translates the given Unicode string using the current system ANSI code page installed at system boot time and converts the translated string to uppercase.

This routine does not modify the source string. It returns a NULL-terminated ANSI string if the given BytesInUnicodeString included a NULL terminator and if the given MaxBytesInMultiByteString did not cause truncation.

For information about other string-handling routines, see Run-Time Library (RTL) Routines.

Requirements

See also

RtlMultiByteToUnicodeN

RtlUnicodeToMultiByteN

RtlUnicodeToMultiByteSize