Função CharToOemA (winuser.h)

Converte uma cadeia de caracteres no conjunto de caracteres definido por OEM.

Syntax

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

Parameters

[in] pSrc

Type: LPCTSTR

A cadeia de caracteres terminada em nulo a ser traduzida.

[out] pDst

Type: LPSTR

O buffer de destino, que recebe a cadeia de caracteres traduzida. 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

Usar essa função incorretamente pode comprometer a segurança do seu programa. 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. Para obter mais informações, consulte Considerações de segurança: Recursos internacionais e considerações de segurança: interface do usuário do Windows.

Requirements

See also

CharToOemBuff

Conceptual

OemToChar

OemToCharBuff

Reference

Strings