Поделиться через


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

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

Warning Do not use. Ознакомьтесь с рекомендациями по безопасности.
 

Syntax

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

Parameters

[in] pSrc

Type: LPCTSTR

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

[out] pDst

Type: LPSTR

Буфер назначения, который получает преобразованную строку. If the CharToOem function is being used as an ANSI function, the string can be translated in place by setting the lpszDst parameter to the same address as the lpszSrc parameter. This cannot be done if CharToOem is being used as a wide-character function.

Return value

Type: BOOL

The return value is always nonzero except when you pass the same address to lpszSrc and lpszDst in the wide-character version of the function. In this case the function returns zero and GetLastError returns ERROR_INVALID_ADDRESS.

Remarks

Security Considerations

Неправильное использование этой функции может нарушить безопасность программы. For example, miscalculating the proper size of the lpszDst buffer, especially when the application is used in both ANSI and Unicode versions, can cause a buffer overflow. Дополнительные сведения см. в статье "Вопросы безопасности: международные функции и вопросы безопасности: пользовательский интерфейс Windows".

Note

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

Requirements

Requirement Value
Минимальный поддерживаемый клиент Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
Target Platform Windows
Header winuser.h (включая Windows.h)
Library User32.lib
DLL User32.dll
API set ext-ms-win-ntuser-chartranslation-l1-1-0 (представлено в Windows 8)

See also

CharToOemBuff

Conceptual

OemToChar

OemToCharBuff

Reference

Strings