Макрос RtlAnsiStringToUnicodeSize (wdm.h)

  • Статья

Подпрограмма RtlAnsiStringToUnicodeSize возвращает количество байтов, необходимое для хранения строки ANSI, преобразованной в строку Юникода.

Синтаксис

//
//  NTSYSAPI
//  ULONG
//  NTAPI
//  RtlAnsiStringToUnicodeSize(
//      PANSI_STRING AnsiString
//      );
//

#define RtlAnsiStringToUnicodeSize(STRING) (                 \
    RtlxAnsiStringToUnicodeSize(STRING)                      \
)

Параметры

[in] STRING

Указатель на буфер, содержащий строку ANSI.

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

None

Remarks

RtlAnsiStringToUnicodeSize возвращает значение ULONG, содержащее количество байтов, необходимых для хранения строки ANSI, преобразованной в строку Юникода.

Приведение возвращаемого значения подпрограммы RtlAnsiStringToUnicodeSize к USHORT может привести к потере данных. Чтобы избежать потенциальных проблем, вызывающие эту подпрограмму должны проверить возвращаемое значение на наличие арифметического переполнения. Обратите внимание, что В RtlAnsiStringToUnicodeSize учитываются конечные значения NULL.

Вызывающие функции RtlAnsiStringToUnicodeSize должны выполняться в среде IRQL = PASSIVE_LEVEL.

Требования

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

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

RtlAnsiStringToUnicodeString

RtlxAnsiStringToUnicodeSize