Функция CharToOemBuffA (winuser.h)

Статья
03/13/2024

Преобразует указанное число символов в строке в набор символов, определяемый OEM.

Синтаксис

BOOL CharToOemBuffA(
  [in]  LPCSTR lpszSrc,
  [out] LPSTR  lpszDst,
  [in]  DWORD  cchDstLength
);

Параметры

[in] lpszSrc

Тип: LPCTSTR

Строка, завершающаяся нулевым значением, которая должна быть преобразована.

[out] lpszDst

Тип: LPSTR

Буфер для переведенной строки. Если функция CharToOemBuff используется в качестве функции ANSI, строку можно преобразовать на месте, задав для параметра lpszDst тот же адрес, что и у параметра lpszSrc . Это невозможно сделать, если CharToOemBuff используется в качестве функции расширенных символов.

[in] cchDstLength

Тип: DWORD

Число символов для перевода в строке, определяемой параметром lpszSrc .

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

Тип: BOOL

Возвращаемое значение всегда не равно нулю, за исключением случаев, когда вы передаете один и тот же адрес lpszSrc и lpszDst в версии функции с расширенными символами. В этом случае функция возвращает ноль, а GetLastError возвращает ERROR_INVALID_ADDRESS.

В отличие от функции CharToOem , функция CharToOemBuff не останавливает преобразование символов при обнаружении пустого символа в буфере, на который указывает lpszSrc. Функция CharToOemBuff преобразует все символы cchDstLength .

Примечание

Заголовок winuser.h определяет CharToOemBuff в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-chartranslation-l1-1-0 (представлено в Windows 8)