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