4D Doc Center : SMTP

4D v13.2

SMTP_Subject


SMTP_Subject ( smtp_ID ; assunto ; excluirOpcao ) -> Resultado

Parâmetro	Tipo	Descrição
smtp_ID	Inteiro longo	Referencia da mensagem
assunto	Texto	Assunto da mensagem
excluirOpcao	Inteiro	0 = Substituir (se assunto não está vazio), 1 = Substituir, 2 = Apagar
Resultado	Inteiro	Código de erro

Descrição

O comando SMTP_Subject agrega o assunto da mensagem à mensagem referenciado por smtp_ID. Se um assunto já foi adicionado por um comando SMTP_Subject, o novo assunto irá anular o assunto anterior.

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

assunto é um valor texto que descrevem de forma concisa o tema tratado em detalhe pelo corpo da mensagem.

Atenção: Geralmente, o assunto da mensagem não deve conter caracteres com signos diacríticos (por exemplo é, ô, etc.) No entanto, se deseja utilizar caracteres "estendidos", consulte as descrições dos comandos SMTP_SetPrefs e SMTP_Charset.

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 "Assunto":

Se passar 0, o conteúdo do parâmetro assunto substitui na área de cabeçalho todo texto presente, se passar uma cadeia vazia em assunto,se conserva o cabeçalho anterior.
Se passar 1, o conteúdo do parâmetro assunto substitui na área de cabeçalho todo texto presente. Neste caso, se passar uma cadeia vazia em assunto, se apaga o cabeçalho "assunto" existente.
Um valor de 2 excluirá o cabeçalho "Assunto" da mensagem.
excluirOpcao é um parâmetro opcional que padrão tem o valor zero.

Exemplo

Ver o exemplo do comando SMTP_Body.