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

Статья
11/20/2024

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

Синтаксис

BOOL CharToOemBuffW(
  [in]  LPCWSTR lpszSrc,
  [out] LPSTR   lpszDst,
  [in]  DWORD   cchDstLength
);

Параметры

[in] lpszSrc

Тип: LPCTSTR

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

[out] lpszDst

Тип: LPSTR

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

[in] cchDstLength

Тип: DWORD

Число символов, которые необходимо перевести в строку, определяемую параметром lpszSrc.

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

Тип: BOOL

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

Замечания

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

Заметка

Заголовок winuser.h определяет CharToOemBuff как псевдоним, который автоматически выбирает версию 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)