Функция 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 (включая Ntddk.h) |
| Библиотека | NtosKrnl.lib |
| DLL | NtosKrnl.exe (режим ядра); Ntdll.dll (пользовательский режим) |
| IRQL | <= APC_LEVEL |