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

Статья
08/08/2023

Подпрограмма RtlUnicodeStringToAnsiString преобразует заданную строку Юникода в строку ANSI.

Синтаксис

NTSYSAPI NTSTATUS RtlUnicodeStringToAnsiString(
  [in, out] PANSI_STRING     DestinationString,
  [in]      PCUNICODE_STRING SourceString,
  [in]      BOOLEAN          AllocateDestinationString
);

Параметры

[in, out] DestinationString

Указатель на структуру ANSI_STRING для хранения преобразованной строки ANSI. Если параметр AllocateDestinationString имеет значение TRUE, подпрограмма выделяет новый буфер для хранения строковых данных и обновляет элемент Bufferэлемента DestinationString , чтобы он указывал на новый буфер. В противном случае подпрограмма использует указанный в данный момент буфер для хранения строки.

[in] SourceString

Указатель на исходную строку Юникода, которая должна быть преобразована в ANSI.

[in] AllocateDestinationString

Значение TRUE , если эта подпрограмма выделяет буферное пространство для DestinationString. Если это так, буфер должен быть освобожден путем вызова RtlFreeAnsiString.

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

Если преобразование выполнено успешно, функция RtlUnicodeStringToAnsiString возвращает STATUS_SUCCESS. В противном случае хранилище не было выделено, и преобразование не выполнялось.

Требования

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

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

ANSI_STRING

RtlAnsiStringToUnicodeString

RtlFreeAnsiString

UNICODE_STRING

Share via