Converte uma string do formato ANSI Text (formato Microsoft Windows) para OEM/MS-DOS

Sintaxe: AnsiToOEM( < cStringAnsi > )

Retorno: Retorna a string convertida (formato OEM/MS-DOS) para ser exibida no MS-DOS

Observações

Este tipo de conversão somente faz-se necessária em condições muito específicas, como por exemplo a geração de um arquivo de texto ou de dados que será lido por um aplicativo que espera tal formato.

A conversão para string OEM parte do princípio do uso da página de código (Codepage) 437, onde nem todos os caracteres Ansi possuem correspondente, como por exemplo o caractere "ã" (letra A minúscula com til): Neste caso, a representação em OEM é feita com o caractere "ä" (a minúsculo com trema).
User Function teste()
   cTexto := "José Coração"
   MsgInfo(cTexto) // mostra no smartclient de forma correta
   cEcho := ANSIToOEM( cTexto )
   conout(cEcho) // mostra no log de console do appserver Windows de forma correta
Return