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


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

Подпрограмма RtlAppendUnicodeToString объединяет предоставленную строку Юникода с буферизованной строкой Юникода.

Синтаксис

NTSYSAPI NTSTATUS RtlAppendUnicodeToString(
  [in, out]      PUNICODE_STRING Destination,
  [in, optional] PCWSTR          Source
);

Параметры

[in, out] Destination

Указатель на буферную строку.

[in, optional] Source

Указатель на строку, завершаемую нулевым значением, которая добавляется к конечной строке.

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

RtlAppendUnicodeToString может возвращать одно из следующих элементов:

Код возврата Описание
STATUS_SUCCESS
Исходная строка была успешно добавлена к целевой строке, а длина конечной строки была обновлена, чтобы включить добавленные байты.
STATUS_BUFFER_TOO_SMALL
Буфер строки назначения слишком мал, чтобы разрешить добавление исходной строки, поэтому длина строки назначения не обновляется, а содержимое буфера строки назначения не изменяется.

Комментарии

RtlAppendUnicodeToString добавляет исходную строку в конец конечной строки.

Если буфер назначения недостаточно велик, чтобы содержать строку, полученную в результате объединения исходной и целевой строк (не включая символ NULL, завершающий исходную строку), подпрограмма возвращает STATUS_BUFFER_TOO_SMALL и оставляет конечную строку без изменений.

Буфер назначения должен быть резидентным, если вызывающий объект выполняется в IRQL >= DISPATCH_LEVEL.

Требования

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

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

RtlAppendUnicodeStringToString