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

Статья
08/27/2023

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

Предупреждение Не используйте. См. раздел Вопросы безопасности.

Синтаксис

BOOL OemToCharA(
  [in]  LPCSTR pSrc,
  [out] LPSTR  pDst
);

Параметры

[in] pSrc

Тип: LPCSTR

Строка символов, завершающаяся null, из набора символов, определяемого OEM.

[out] pDst

Тип: LPTSTR

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

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

Тип: BOOL

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

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

Требования


Минимальная версия клиента	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)