RtlUpcaseUnicodeString
TOC
Collapse the table of content
Expand the table of content

RtlUpcaseUnicodeString routine

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

Syntax


NTSTATUS RtlUpcaseUnicodeString(
  _Inout_ PUNICODE_STRING  DestinationString,
  _In_    PCUNICODE_STRING SourceString,
  _In_    BOOLEAN          AllocateDestinationString
);

Parameters

DestinationString [in, out]

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

SourceString [in]

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

AllocateDestinationString [in]

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

Target platform

Universal

Version

Available starting with Windows 2000.

Header

Ntddk.h (include Ntddk.h)

Library

NtosKrnl.lib

DLL

NtosKrnl.exe

IRQL

<= APC_LEVEL

See also

RtlFreeUnicodeString
RtlUpcaseUnicodeChar

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft