Функция RtlUnicodeToOemN (ntifs.h)
Подпрограмма RtlUnicodeToOemN преобразует заданную строку Юникода в строку OEM, используя текущую кодовую страницу OEM.
Синтаксис
NTSYSAPI NTSTATUS RtlUnicodeToOemN(
[out] PCHAR OemString,
[in] ULONG MaxBytesInOemString,
[out, optional] PULONG BytesInOemString,
[in] PCWCH UnicodeString,
[in] ULONG BytesInUnicodeString
);
Параметры
[out] OemString
Указатель на выделенный вызывающим буфером для получения переведенной строки.
[in] MaxBytesInOemString
Максимальное число байтов, записываемых в OemString.
[out, optional] BytesInOemString
Указатель на выделенную вызывающим переменную, которая получает количество байтов в переведенной строке. Этот параметр может быть NULL.
[in] UnicodeString
Указатель на исходную строку Юникода, которая будет переведена.
[in] BytesInUnicodeString
Размер строки в байтах в ЮникодСтринг.
Возвращаемое значение
RtlUnicodeToOemN возвращает STATUS_SUCCESS, если полная строка в UnicodeString была переведена и возвращена в OemString.
Замечания
Для возвращаемого значения STATUS_BUFFER_OVERFLOW усеченная строка по OemString была переведена без ошибок.
Для возвращаемого значения STATUS_SUCCESS значение по BytesInOemString , если таковой имеется, указывает длину возвращаемой строки, а не заданную MaxBytesInOemString.
RtlUnicodeToOemN не изменяет исходную строку. Он возвращает строку OEM, завершающую значение NULL, если указанный BytesInUnicodeString включал конца NULL, а если указанный MaxBytesInOemString не вызвал усечение.
Дополнительные сведения о других подпрограммах обработки строк см. в Run-Time подпрограммах библиотеки (RTL).
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| заголовка | ntifs.h (include Ntifs.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |