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

Статья
11/20/2024

Преобразует указанное число символов в строке из определяемого OEM символа в an ANSI или строку с расширенным символом.

Синтаксис

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

Параметры

[in] lpszSrc

Тип: LPCSTR

Один или несколько символов из определяемого изготовителем набора символов.

[out] lpszDst

Тип: LPTSTR

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

[in] cchDstLength

Тип: DWORD

Количество символов, которые необходимо преобразовать в буфере, определяемое параметром lpszSrc.

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

Тип: BOOL

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

Замечания

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll
набор API	ext-ms-win-ntuser-chartranslation-l1-1-0 (представлено в Windows 8)