Функция RtlUnicodeStringInit (ntstrsafe.h)

Статья
07/16/2024

Функция RtlUnicodeStringInit инициализирует структуру UNICODE_STRING.

Синтаксис

NTSTRSAFEDDI RtlUnicodeStringInit(
  [out]          PUNICODE_STRING  DestinationString,
  [in, optional] NTSTRSAFE_PCWSTR pszSrc
);

Параметры

[out] DestinationString

Указатель на инициализацию UNICODE_STRING структуры. Указатель pszSrc копируется в структуру UNICODE_STRING параметра DestinationStr ing. Максимальное количество символов в строке, на которую pszSrc указывает NTSTRSAFE_UNICODE_STRING_MAX_CCH.

[in, optional] pszSrc

Необязательный. Указатель на константу строки, завершаемой значением NULL. Этот указатель строки будет скопирован в элемент буфера буфера структуры UNICODE_STRING, на которую указывает параметр DestinationString. Этот указатель строки может быть null.

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

RtlUnicodeStringInit возвращает одно из следующих значений NTSTATUS.

Возвращаемый код	Описание
STATUS_SUCCESS	Это успешном состоянии означает, что исходные данные были представлены, строка была скопирована без усечения, а результирующий целевой буфер завершается значением NULL.
STATUS_INVALID_PARAMETER	Это состояние означает, что функция получила недопустимый входной параметр. Дополнительные сведения см. в следующем списке.

RtlUnicodeStringInit возвращает значение STATUS_INVALID_PARAMETER при возникновении одной из следующих ситуаций:

Длина строки, на которую указывает параметр pszSrc, больше NTSTRSAFE_UNICODE_STRING_MAX_CCH символов.
Указатель DestinationStringNULL, но указатель pszSrc не NULL.

Сведения об тестировании значений NTSTATUS см. в использование значений NTSTATUS.

Замечания

Функция RtlUnicodeStringInit RtlUnicodeStringInit выполняет следующие действия:

Задает элемент length структуры UNICODE_STRING, на которую указывает параметр pszSrc длину в байтах строки, на которую указывает параметр pszSrc.
Задает элемент MaximumLength структуры UNICODE_STRING длину (в байтах) строки, на которую указывает параметр pszSrc плюс 2 байта.
Задает элемент буфера структуры UNICODE_STRING адресом, который указывает параметр pszSrc.

Указатель DestinationString не должен быть null. Если необходимо указать значения указателя NULLDestinationString, используйте функцию RtlUnicodeStringInitEx.

Дополнительные сведения о функциях безопасной строки см. в разделе Использование безопасных строковых функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows XP с пакетом обновления 1 (SP1).
целевая платформа	Настольный
заголовка	ntstrsafe.h (include Ntstrsafe.h)
библиотеки	Ntstrsafe.lib
IRQL	Любой, если управляемые строки всегда находятся в памяти, в противном случае PASSIVE_LEVEL

См. также

RtlUnicodeStringInitEx

UNICODE_STRING

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