Функция 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 |