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

  • Статья

Подпрограмма 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