Функция RtlOemStringToUnicodeString (ntifs.h)
Подпрограмма RtlOemStringToUnicodeString преобразует заданную исходную строку в строку Юникода, завершающуюся null, с помощью текущей системной кодовой страницы OEM.
Синтаксис
NTSYSAPI NTSTATUS RtlOemStringToUnicodeString(
PUNICODE_STRING DestinationString,
[in] PCOEM_STRING SourceString,
[in] BOOLEAN AllocateDestinationString
);
Параметры
DestinationString
Указатель на буфер, выделенный вызывающим объектом, для получения переведенной строки. Если параметр AllocateDestinationString имеет значение FALSE, вызывающий объект также должен выделить буфер для элемента Bufferэлемента DestinationString , чтобы вместить строку Юникода, завершающуюся null. Если параметр AllocateDestinationString имеет значение TRUE, RtlOemStringToUnicodeString выделяет буфер, достаточно большой для хранения строки, передает указатель на него в буфере и соответствующим образом обновляет элементы длины и максимальной длины DestinationString .
[in] SourceString
Указатель на строку OEM, которая будет преобразована в Юникод.
[in] AllocateDestinationString
Задайте значение TRUE , если RtlOemStringToUnicodeString должен выделить буферное пространство для DestinationString, в противном случае — FALSE . Если этот параметр имеет значение TRUE, вызывающий объект отвечает за освобождение буфера, когда он больше не нужен, вызывая RtlFreeUnicodeString.
Возвращаемое значение
RtlOemStringToUnicodeString возвращает STATUS_SUCCESS, если возвращает переведенную строку в DestinationString. В противном случае хранилище не выделено и преобразование не было выполнено.
Комментарии
RtlOemStringToUnicodeString преобразует заданную исходную строку с помощью кодовой страницы OEM, которая была установлена в качестве текущей системной кодовой страницы во время загрузки системы.
Эта подпрограмма не изменяет исходную строку. Он возвращает строку Юникода, завершаемую значением NULL.
Сведения о других процедурах обработки строк см. в статье Подпрограммы библиотеки времени выполнения (RTL).
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Верхняя часть | ntifs.h (включая Ntifs.h) |
| Библиотека | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |