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


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

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