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