Функция RtlUpcaseUnicodeString (ntddk.h)
Подпрограмма RtlUpcaseUnicodeString преобразует копию исходной строки в верхний регистр и записывает преобразованную строку в буфер назначения.
Синтаксис
NTSYSAPI NTSTATUS RtlUpcaseUnicodeString(
[in, out] PUNICODE_STRING DestinationString,
[in] PCUNICODE_STRING SourceString,
[in] BOOLEAN AllocateDestinationString
);
Параметры
[in, out] DestinationString
Указатель на выделенный вызывающим буфером для преобразованной строки Юникода.
[in] SourceString
Указатель на исходную строку Юникода, которая будет преобразована в верхний регистр.
[in] AllocateDestinationString
Указывает, следует ли RtlUpcaseUnicodeString выделить буферное пространство для DestinationString. Если это так, буфер должен быть освобожден путем вызова RtlFreeUnicodeString.
Возвращаемое значение
Если операция выполнена успешно, RtlUpcaseUnicodeString возвращает STATUS_SUCCESS. В противном случае хранилище не было выделено, и преобразование не было выполнено.
Требования
Требование | Ценность |
---|---|
минимальные поддерживаемые клиентские | Доступно начиная с Windows 2000. |
целевая платформа | Всеобщий |
заголовка | ntddk.h (include Ntddk.h) |
библиотеки | NtosKrnl.lib |
DLL | NtosKrnl.exe (режим ядра); Ntdll.dll (режим пользователя) |
IRQL | <= APC_LEVEL |