SMTP_Comments

4D v20

SMTP_Comments


SMTP_Comments ( smtp_ID ; comentarios {; excluirOpcao} ) -> Resultado

Parâmetro	Tipo	Descrição
smtp_ID	Inteiro longo	Referencia da mensagem
comentarios	Texto	Texto do comentário
excluirOpcao	Inteiro	0 = Substituir (se comentários não está vazio), 1 = Substituir, 2 = Excluir
Resultado	Inteiro	Código de erro

Descrição

O comando SMTP_Comments permite ao usuário adicionar comentários à mensagem sem modificar o corpo da mensagem. Os comentários só aparecem na área de cabeçalho da mensagem. Muitos softwares de correio não mostram o texto completo dos cabeçalhos da mensagem a seus usuários.

smtp_ID é a referencia inteiro longo de um email criado com o comando SMTP_New.

comentarios contém o texto a colocar como comentário no cabeçalho da mensagem.

Atenção: O texto não deve conter retornos de linha (ASCII = 10). Um retorno de linha significa o final da seção de cabeçalho e o começo do corpo. Os cabeçalhos posteriores poderiam ser considerados como o corpo do texto e não ser reconhecidos corretamente pelo software do servidor ou do cliente. Para obter mais informação sobre os cabeçalhos, consulte a RFC#822.

excluirOpcao é um valor inteiro que especifica se deve ser conservado ou excluído o cabeçalho "Comentários":

Se passar zero, o conteúdo do parâmetro comentarios substituirá na área de cabeçalho todo texto presente, se passar uma cadeia vazia em comentarios, é conservado o cabeçalho anterior.
Se passar 1, o conteúdo do parâmetro comentarios substituirá na área de cabeçalho de todo texto presente. Neste caso, se passar uma cadeia vazia em comentarios , é apagado o cabeçalhp "Comentários".
Se passar um valor de 2, o cabeçalho "Comentários" é apagado da mensagem.
excluirOpcao é um parâmetro opcional que por padrão tem o valor de zero.

Exemplo

Ver o exemplo do comando SMTP_Body.

Ver também

SMTP_New