RtlUpcaseUnicodeString

NTSTATUS
    RtlUpcaseUnicodeString(
        IN OUT PUNICODE_STRING  DestinationString,        /* optional */
        IN PUNICODE_STRING  SourceString,
        IN BOOLEAN  AllocateDestinationString
        );

RtlUpcaseUnicodeString converts a copy of the source string to upper case and writes the converted string in the destination buffer.

Parameters

DestinationString

Points to a caller-allocated buffer for the converted Unicode string or is NULL if AllocateDestinationString is set to TRUE.

SourceString

Points to the source Unicode string to be converted to upper case.

AllocateDestinationString

TRUE 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.

Comments

Callers of RtlUpcaseUnicodeString must be running at IRQL PASSIVE_LEVEL.

See Also

RtlFreeUnicodeString