Поделиться через


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

См. также

RtlFreeUnicodeString

RtlUpcaseUnicodeChar