Функция RtlIntegerToUnicodeString (wdm.h)

Статья
08/08/2023

Подпрограмма RtlIntegerToUnicodeString преобразует целочисленное значение без знака в строку, завершающуюся значением NULL из одного или нескольких символов Юникода в заданной базе.

Синтаксис

NTSYSAPI NTSTATUS RtlIntegerToUnicodeString(
  [in]           ULONG           Value,
  [in, optional] ULONG           Base,
  [in, out]      PUNICODE_STRING String
);

Параметры

[in] Value

Указывает значение ULONG для преобразования.

[in, optional] Base

Задает базу, используемую при преобразовании значения в строку. Вы можете выбрать

Значение	Основной
16	Шестнадцатеричный
8	Восьмеричное
2	Двоичные данные
0 или 10	Decimal

[in, out] String

Указатель на структуру UNICODE_STRING , получающую строковое представление Значения. Буфер, заданный буферомстроки , должен быть достаточно большим, чтобы вместить результат.

Возвращаемое значение

RtlIntegerToUnicodeString возвращает значение NTSTATUS. Возможные возвращаемые значения:

Код возврата	Описание
STATUS_SUCCESS	Подпрограмма успешно преобразует Значение в строку Юникода.
STATUS_BUFFER_OVERFLOW	Значение слишком велико для преобразования или структура UNICODE_STRING слишком мала для хранения результата.
STATUS_INVALID_PARAMETER	Указанная база кода недопустимая. Допустимы только значения 0, 2, 8, 10 и 16.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 2000.
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe (режим ядра); Ntdll.dll (пользовательский режим)
IRQL	PASSIVE_LEVEL

См. также раздел

RtlAppendUnicodeStringToString

RtlUnicodeStringToInteger

UNICODE_STRING

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