RtlUpcaseUnicodeString routine

RtlUpcaseUnicodeString routine

RtlUpcaseUnicodeString 转换一个源字符串到大写格式，并把转换后的字符串写入到目标缓冲区中。

Syntax

 

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

Parameters

DestinationString [in, out]

指向用户申请的缓冲区，用它来放转换后的Unicode字符串。

SourceString [in]

指向将要被转换为大写的源字符串

AllocateDestinationString [in]

指定 RtlUpcaseUnicodeString 是否要为DestinationString申请缓冲区空间，如果是则必须使用 RtlFreeUnicodeString回收内存缓冲区。

Return value

操作成功RtlUpcaseUnicodeString 返回 STATUS_SUCCESS. 否则没有任何存储空间被申请也没有执行任何转换。

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