SMTP_SetPrefs

4D Internet Commands v16

SMTP_SetPrefs


SMTP_SetPrefs ( retornoLinha ; tipoCorpo ; longLinha ) -> Resultado

Parâmetro	Tipo	Descrição
retornoLinha	Inteiro	1 = [por padrão] Adicionar, 0 = Não adicionar, -1 = Não mudar
tipoCorpo	Inteiro longo	Conjunto de caracteres do corpo da mensagem, cabeçalhos e nomes de arquivos adjuntos, assim como também codificação de corpo (-1 = sem mudança)
longLinha	Inteiro longo	Longitude de linha máxima (0 = [por padrão] Detecção automática, -1 = Nenhuma modificação)
Resultado	Inteiro	Código de erro

Descrição

O comando SMTP_SetPrefs define as preferências das mensagens SMTP a enviar. O comando tem um alcance global e interprocesso e afeta a todas as mensagens posteriores criadas com os comandos SMTP. As opções configuráveis afetam o formato de uma mensagem que é enviada a um servidor SMTP com os comandos SMTP_QuickSend ou SMTP_Send. A configuração das preferências tem um alcance interprocesso e afeta a criação de mensagens em qualquer processo 4D.

Os servidores SMTP requerem a combinação de caracteres retorno de carro/retorno de linha (CR/LF) para indicar o final de uma linha. Isto difere da maioria das aplicações Macintosh, que consideram um retorno de carro como um marcador de fim de linha ou de parágrafo.

retornoLinha é um valor inteiro que especifica como lidar com os retornos de carro no corpo de uma mensagem. Passar um valor de zero neste parâmetro deixa o texto do corpo da mensagem intacto, o que permite ao desenvolvedor controlar suas próprias adiciones de retornos de linha. Um valor de 1 (parâmetro por padrão), substitui automaticamente todos os retorno de carro/retorno linha por retornos de carro sozinhos. Um valor de -1 deixa o valor atual da preferência intacto. Se não está seguro de qual opção escolher, deve escolher 1, o valor por padrão.

tipoCorpo especifica o conjunto de caracteres usados no corpo da mensagem a enviar (Body-Content-Type) assim como a codificação aa plicar ao corpo da mensagem (Content-Transfer-Encoding), de acordo com os valores da tabela abaixo. Por exemplo, “US-ASCII & 7 bit” (valor 2) significa que o tipo de caractere do corpo da mensagem atualmente em uso é supsotamente US ASCII — inclui apenas códigos padrão ASCII (0 a 127) que são comuns a Windows e Macintosh— e que 4D IC codifica o corpo da mensagem usando codificação 7 bits . Note que o comando SMTP_SetPrefs NÂO converte o corpo da mensagem usando o conjunto de caracteres especificado, isto tem que ser gerenciadeo pelo usuário se necessário. Se quiser forçar a conversão de tipo de caracteres, veja a descrição do comando SMTP_Charset.
Se não for mudado, o tipo de conteúdo padrão é 1, que permite aos comandos SMTP que auto-detectem um padrão apropriado baseado nos conteúdos do corpo da mensagem.

Valor em charset&encoding	Charset e codificação corpo mensagem	Charset para cabeçalhos e nomes de arquivos anexados
-1	Sem mudança	Sem mudança
0	Application & binary; no encoding	ISO-8859-1
1	Default: UTF-8 & base64	Default: UTF-8 para assunto, ISO-8859-1 para outros campos
2	US-ASCII & 7bit	ISO-8859-1
3	US-ASCII & quotable-printable	ISO-8859-1
4	US-ASCII & base64	ISO-8859-1
5	ISO-8859-1 & quotable-printable	ISO-8859-1
6	ISO-8859-1 & base64	ISO-8859-1
7	ISO-8859-1 & 8bit	ISO-8859-1
8	ISO-8859-1 & binary	ISO-8859-1
9	Reservado	Reservado
10	ISO-2022-JP (Japanese) & 7 bit	ISO-2022-JP
11	ISO-2022-KR (Korean) & 7 bit	ISO-2022-KR
12	ISO-2022-CN (Traditional & Simplified Chinese) & 7 bit	ISO-2022-CN
13	HZ-GB-2312 (Simplified Chinese) & 7 bit	HZ-GB-2312
14	Shift-JIS (Japanese) & base64	Shift-JIS
15	UTF-8 & quoted-printable	UTF-8
16	UTF-8 & base64	UTF-8

Aviso: O caractere € ("euro") não faz parte de ISO-8859-1.

larguraLinha especifica uma largura de linha máxima SMTP para texto dentro do corpo da mensagem. Os comandos SMTP vão quebrar as linhas do texto do corpo inserindo retornos de carro no ponto mais próximo de separação de palavras antes do tamanho máximo de linha. Qualquer número pode ser especidifcado mas é recomendável que a largura da linha seja mantida menor que 80 caracteres. Um valor de -1 deixa o valor atual sem modificar

O parâmetro padrão para larguraLinha é zero. Um valor de zero faz com que os comandos SMTP usem os valores recomendados especificados dentro das definições RFC para charset&encoding. Se o parâmetro larguraLinha for estabelecido em zero, A quebra de linha ocorre de acordo com a tabela abaixo:

Tipo Corpo	Quebra em
Base64	76
Quoted-Printable	76
Outro…	sem quebra

Quebra de linhas é fortemente sugerido já que muitos sistemas e programas de mail tem problemas lidando com mensagens que contém larguras de linha ilimitadas. Lembre também que email frequentemente viaja através de um grande número de sistemas antes de alcançar seu destino final e qualquer computador ao longo da rota de envio pode rejeitar a mensagem se não conseguir lidar com o formato da mensagem.

Exemplo

O seguinte código envia uma mensagem em UTF-8 codificado em quotedprintable. (Cabeçalhos continuam no conjunto de caracteres padrão)::

 $err:=SMTP_SetPrefs(-1;15;-1)

 $err:=SMTP_Charset(0;1) //applicar preferências

 $err:=SMTP_QuickSend("mymail.com";"myaddress";"destination";"the Euro €";"the Euro symbol is €")

Ver também

SMTP_Charset
SMTP_GetPrefs