Функция RtlUnicodeStringToCountedOemString (ntifs.h)

Подпрограмма RtlUnicodeStringToCountedOemString преобразует указанную исходную строку Юникода в подсчитываемую строку OEM с помощью текущей кодовой страницы OEM системы.

Синтаксис

NTSYSAPI NTSTATUS RtlUnicodeStringToCountedOemString(
       POEM_STRING      DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

Параметры

DestinationString

Указатель на выделенный вызывающим буфером для получения подсчетной строки OEM. Если AllocateDestinationStringfalse, вызывающий объект также должен выделить буфер для элемента буфера DestinationString для хранения данных OEM. Если AllocateDestinationStringTRUE, RtlUnicodeStringToCountedOemString выделяет буфер достаточно большой для хранения строки, передает указатель на него в буфере, а также обновляет элементы длины и максимальной длины DestinationString соответственно.

[in] SourceString

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

[in] AllocateDestinationString

Задайте значение TRUE, если RtlUnicodeStringToCountedOemString должен выделить буферное пространство для DestinationString, FALSE противном случае. Если этот параметр TRUE, вызывающий объект отвечает за освобождение буфера, если он больше не нужен путем вызова RtlFreeOemString.

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

RtlUnicodeStringToCountedOemString возвращает STATUS_SUCCESS, если строка в DestinationString преобразуется. В противном случае хранилище не было выделено, и преобразование не было выполнено. Эта подпрограмма возвращает STATUS_UNMAPPABLE_CHARACTER, если не удается перевести символ в заданной SourceString.

Замечания

RtlUnicodeStringToCountedOemString возвращает переведенную строку, которая не содержит конца NULL. Он преобразует указанную исходную строку с помощью кодовой страницы OEM, установленной в качестве текущей системной кодовой страницы во время загрузки системы.

RtlUnicodeStringToCountedOemString не изменяет исходную строку.

Дополнительные сведения о других подпрограммах обработки строк см. в Run-Time подпрограммах библиотеки (RTL).

Требования

См. также

OEM_STRING

RtlFreeOemString

RtlOemStringToCountedUnicodeString

RtlUnicodeStringToOemString

RtlUnicodeToOemN

RtlUpcaseUnicodeStringToCountedOemString

UNICODE_STRING