Функция WdmlibRtlInitUnicodeStringEx (wdmsec.h)

  • Статья

Функция WdmlibRtlInitUnicodeStringEx инициализирует подсчитываемую строку символов Юникода.

Синтаксис

NTSTATUS WdmlibRtlInitUnicodeStringEx(
  [out]          PUNICODE_STRING DestinationString,
  [in, optional] PCWSTR          SourceString
);

Параметры

[out] DestinationString

Указатель на инициализируемый UNICODE_STRING структуру.

[in, optional] SourceString

Указатель на строку расширенных символов, завершаемую null. Эта строка используется для инициализации подсчитываемой строки, на которую указывает DestinationString.

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

WdmlibRtlInitUnicodeStringEx возвращает STATUS_SUCCESS в случае успешного выполнения. В противном случае метод может вернуть другие значения NTSTATUS.

Комментарии

Подпрограмма копирует значение указателя SourceString в элемент Bufferструктуры UNICODE_STRING , на которую указывает DestinationString. Элементу Length этой структуры присваивается длина исходной строки в байтах, за исключением завершающего значения NULL. Для элемента MaximumLength структуры задается длина исходной строки в байтах, включая завершающее значение NULL. Если параметр SourceString имеет значение NULL, то значения Length и MaximumLength равны нулю.

WdmlibRtlInitUnicodeStringEx не изменяет исходную строку, на которую указывает SourceString.

Примечание

Если длина исходной строки превышает MAX_USTRING –1 байт, WdmlibRtlInitUnicodeStringEx задает элементу Lengthструктуры UNICODE_STRING , на которую указывает DestinationString , значение MAX_USTRING – 2, а для элемента MaximumLength этой структуры — MAX_USTRING. В этом случае значения Length и MaximumLength искажают длину исходной строки, завершаемой значением NULL, и полагаться на точность этих значений потенциально опасно.

Вызывающие методы WdmlibRtlInitUnicodeStringEx могут выполняться в среде IRQL <= DISPATCH_LEVEL, если буфер DestinationString недоступен для страницы. Как правило, вызывающие методы выполняются в IRQL = PASSIVE_LEVEL, так как большинство других процедур RtlXxxString не могут быть вызваны на PASSIVE_LEVEL IRQL > .

Требования

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

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