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 |