4D v13.2

SMTP_AddHeader

Página Inicial

 
4D v13.2
SMTP_AddHeader

SMTP_AddHeader 


 

SMTP_AddHeader ( smtp_ID ; nomeCabe ; textoCabe ; excluirOpcao ) -> Resultado 
Parâmetro Tipo   Descrição
smtp_ID  Inteiro longo in Referencia da mensagem
nomeCabe  cadeia in Nome do cabeçalho
textoCabe  Texto in Texto do cabeçalho
excluirOpcao  Inteiro in 0 = Adicionar 1 = Substituir todos os cabeçalhos com 'nomeCabe', 2 = Excluir todos os cabeçalhos chamados 'nomeCabe'
Resultado  Inteiro in Código de erro

O comando SMTP_AddHeader permite aos usuários adicionar seus próprios cabeçalhos a mensagem referenciada por smtp_ID. Além dos cabeçalhos estandarte diretamente gerados pelos comandos Internet de 4D, há duas categorias de cabeçalhos adicionais, os cabeçalhos "usuário" (definidos pelo usuário) e os cabeçalhos "estendidos". O comando SMTP_AddHeader permite ao usuário adicionar o novo cabeçalho e os dados a associar a ele.

Cabeçalhos "estendidos": Estes Cabeçalhos têm sido oficialmente reconhecidos pelo NIC e se definiram depois das especificações SMTP iniciais. Estes cabeçalhos muitas vezes têm uma função específica afetando o comportamento das diferentes aplicações de software. Os cabeçalhos "estendidos" nunca começam pela letra "X".

Cabeçalhos "usuário": O protocolo SMTP permite que qualquer possa criar suas próprias definições de cabeçalho. Todos os cabeçalhos definidos pelo usuário devem começar pelos caracteres "X-" para evitar todo conflito com um futuro cabeçalho "estendido". Os cabeçalhos "usuário" são particularmente úteis quando você controla ambos extremos da comunicação.

Os cabeçalhos "usuário" permitem ao desenvolvedor armazenar dados que podem extrair facilmente com o comando POP3 MSG_FindHeader. Por exemplo, pode criar um cabeçalho chamado "X-001001", que contém o valor no campo 01 do arquivo 01. Pode agregar um número ilimitado de cabeçalhos a uma mensagem. Os cabeçalhos "usuário" dão ao usuário a possibilidade de adicionar a informação mais fácil de extrair sem necessidade de analisar o corpo da mensagem.

smtp_ID é a referencia inteiro longo de uma mensagem eletrônica criado com o comando SMTP_New.

nomeCabe contém o nome do cabeçalho a ser adicionado.

textoCabe contém a informação que será assinalada na área de cabeçalho identificada por nomeCabe.

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 permite precisar se deseja eliminar o cabeçalho atual. Se passar zero, o cabeçalho nomeCabe é adicionado à mensagem. Se passar 1, todos os cabeçalhos da mensagem será substituído pelo cabeçalho nomeCabe. Neste caso, se nomeCabe é uma cadeia vazia, todos os cabeçalhos serão eliminados. Se passar 2, todos os cabeçalhos nomeCabe são eliminados da mensagem.

Exemplo  

Para enviar um mail em HTML, deve inserir etiquetas HTML no corpo da mensagem (ex. <HTML>, <HEAD>, etc.) e os cabeçalhos "Content-Type" devem ser substituídos por "text/html;charset=us-ascii":

 If(Substring($body;1;6)="<HTML>")
    $err:=SMTP_AddHeader($SMTP_ID;"Content-Type:";"text/html;charset=us-ascii";1)
 End if

 
PROPRIEDADES 

Produto: 4D
Tema: IC Send Mail
Número 88975

 
INDEX

Lista alfabética dos comandos

 
HISTÓRIA 

Criado por: 4D Internet Commands 6.5

 
VER TAMBÉM 

MSG_FindHeader
SMTP_New