4D Doc Center : SMTP

4D Internet Commands v14

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.

Notas:

Por padrão, o cabeçalho "Assunto" da mensagem está codificado em UTF-8 o que garante que os caracteres enviados serão interpretados corretamente por quase todos os clientes de correio eletrônico. Se deseja utilizar um conjunto de caracteres específicos, consulte os comandos SMTP_SetPrefs e [#cmd id="88892"/].

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.