---
name: "RtlUpcaseUnicodeString"
section: "3w"
platform: "linux"
package: "libwine-dev"
version: "1.4.1-4"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/RtlUpcaseUnicodeString"
---

# RtlUpcaseUnicodeString(3w)

## NAME

**RtlUpcaseUnicodeString** (NTDLL.@)

## SYNOPSIS

NTSTATUS RtlUpcaseUnicodeString\
  (\
   UNICODE\_STRING\*       *dest*,\
   const UNICODE\_STRING\* *src*,\
   BOOLEAN               *doalloc*\
  )

## DESCRIPTION

Converts a Unicode string to uppercase.

## PARAMS

*dest* **\[Out\]**  Destination for converted string.

*src* **\[In\]**  Source string to convert.

*doalloc* **\[In\]**  **TRUE**=Allocate a buffer for *dest* if it doesn't have one.

## RETURNS

**Success:** **STATUS\_SUCCESS**. *dest* contains the converted string.

**Failure:** **STATUS\_NO\_MEMORY**, if *doalloc* is **TRUE** and memory allocation fails, or **STATUS\_BUFFER\_OVERFLOW**, if *doalloc* is **FALSE** and *dest* is too small.

## NOTES

*dest* is never **' '** terminated because it may be equal to *src*, and *src* might not be **' '** terminated. *dest-\>Length* is only set upon success.

## IMPLEMENTATION

Declared in **"winternl.h"**.

Implemented in **"dlls/ntdll/rtlstr.c"**.

Debug channel **"ntdll"**.