RtlUpcaseUnicodeString 函式 (ntddk.h)

RtlUpcaseUnicodeString 例程會將來源字串的複本轉換成大寫,並在目的地緩衝區中寫入已轉換的字串。

語法

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

參數

[in, out] DestinationString

已轉換 Unicode 字串之呼叫端配置的緩衝區指標。

[in] SourceString

要轉換成大寫的來源 Unicode 字串指標。

[in] AllocateDestinationString

指定 RtlUpcaseUnicodeString 是否要配置 DestinationString 的緩衝區空間。 如果這樣做,則必須藉由呼叫 RtlFreeUnicodeString 來解除分配緩衝區。

傳回值

如果作業成功, RtlUpcaseUnicodeString 會傳回STATUS_SUCCESS。 否則,不會配置任何記憶體,也不會進行轉換。

規格需求

需求
最低支援的用戶端 從 Windows 2000 開始提供。
目標平台 Universal
標頭 ntddk.h (包含 Ntddk.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe (核心模式) ;Ntdll.dll (使用者模式)
IRQL <= APC_LEVEL

另請參閱

RtlFreeUnicodeString

RtlUpcaseUnicodeChar