Edit

RtlUpcaseUnicodeString function (ntddk.h)

  • Article

The RtlUpcaseUnicodeString routine converts a copy of the source string to uppercase and writes the converted string in the destination buffer.

Syntax

NTSYSAPI NTSTATUS RtlUpcaseUnicodeString(
  [in, out] PUNICODE_STRING  DestinationString,
  [in]      PCUNICODE_STRING SourceString,
  [in]      BOOLEAN          AllocateDestinationString
);

Parameters

[in, out] DestinationString

Pointer to a caller-allocated buffer for the converted Unicode string.

[in] SourceString

Pointer to the source Unicode string to be converted to uppercase.

[in] AllocateDestinationString

Specifies if RtlUpcaseUnicodeString is to allocate the buffer space for the DestinationString. If it does, the buffer must be deallocated by calling RtlFreeUnicodeString.

Return value

If the operation succeeds, RtlUpcaseUnicodeString returns STATUS_SUCCESS. Otherwise, no storage was allocated, and no conversion was done.

Requirements

Requirement Value
Minimum supported client Available starting with Windows 2000.
Target Platform Universal
Header ntddk.h (include Ntddk.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe (kernel mode); Ntdll.dll (user mode)
IRQL <= APC_LEVEL

See also

RtlFreeUnicodeString

RtlUpcaseUnicodeChar