4D Doc Center : SMTP

4D v13.2

SMTP_QuickSend


SMTP_QuickSend ( nomeServidor ; msgDe ; msgA ; assunto ; mensagem {; paramSessao}{; port}{; userName ; password} ) -> Resultado

Parâmetro	Tipo	Descrição
nomeServidor	cadeia	Nome ou endereço IP do servidor
msgDe	Texto	Endereço de email ou lista de endereços
msgA	Texto	Endereço de email ou lista de endereços
assunto	Texto	Assunto da mensagem
mensagem	Texto	Mensagem
paramSessao	Inteiro longo	1 = Utilizar SSL, 0 se omite = Não utilizar SSL
port	Inteiro longo	Number of port to use
userName	Texto	User name for authentication
password	Texto	Password for authentication
Resultado	Inteiro	Código de erro

Descrição

O comando SMTP_QuickSend permite criar e enviar uma mensagem com um só comando. Se requer um maior controle sobre a mensagem ou se a mensagem é mais complexa, utilize o comando SMTP_New.

nomeServidor contém o nome ou o endereço IP do servidor SMTP que será encarregado da distribuição da mensagem.

msgDe contém um ou mais emails completos indicando quem enviou a mensagem originalmente. Todas os endereços que figuram no cabeçalho De são visíveis para todos os destinatários da mensagem.

msgA contém um ou mais emails completos. Os endereços identificados no cabeçalho msgA recebem uma copia original da mensagem. Cada destinatário da mensagem pode ver os outros emails os quais foram enviados a mensagem.

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.

mensagem é um valor texto que contém o corpo da mensagem. Por razões históricas, o tamanho da mensagem está limitado a 32 KB.

O parâmetro opcional paramSessao permite ativar o protocolo SSL para a conexão:

O parâmetro opcional paramSessao permite ativar o protocolo SSL para a conexão:
- Se passar 0 ou omite este parâmetro, a mensagem será enviada em modo padrão não seguro. Se o servidor propõe uma atualização a SSL/TLS depois da autenticação, a báscula se realiza automaticamente (funcionamento do SSL/TLS em modo explícito).
- Se passar 1, o envio da mensagem se realiza em SSL (modo síncrono),
- Se passar 0 ou omite este parâmetro, a conexão se realiza em modo padrão, não seguro.
- Se passar 2, a mensagem será enviada em modo padrão mas sem suporte de atualização em SSL/TLS.
O parâmetro opcional porta especifica o número de porta SMTP a utilizar para a conexão com o servidor. Os valores utilizados com mais frequência são:
- 25 = porta STMP padrão não seguro (porta por padrão se o parâmetro se omite)
- 465 = porta SMTPS (SSL/TLS)
- 587 = porta STMP padrão (seguro); passe esta porta para conexões com um servidor MS Exchange (modo explícito).
Os parâmetros opcionais nomeUsuario e senha se utilizam para autenticar o remitente com o servidor de correio. Estes parâmetros devem passar em conjunto. Note que o modo de autenticação mais seguro suportado pelo servidor será o utilizado (como o modo por padrão do comando SMTP_Auth).

Exemplo 1

Exemplo de uso deste comando:

 $Host:="www.4d.com"

 $ToAddress:="adupont@4d.fr"

 $FromAddress:="jsmith@4d.com"

 $Subject:="Relatórios de vendas"

 $Message:="Poderia me enviar o relatório de vendas de janeoio de 2009? Obrigado."

 $Error:=SMTP_QuickSend($Host;$FromAddress;$ToAddress;$Subject;$Message;1)

 If($Error#0)

    ALERT("Error: SMTP_QuickSend"+Char(13)+IT_ErrorText($Error))

 End If

Exemplo 2

Exemplo de utilização do comando para um envio de mensagem seguro via um servidor MS Exchange:

 $ServerName:="exchange.4d.com"

 $MsgTo:="adupont@gmail.com"

 $MsgFrom:="a.user@4d.com"

 $Subject:="Test message"

 $Message:="This is a test for sending a message in secure mode. Please do not reply."

 $Error:=SMTP_QuickSend($ServerName;$MsgFrom;$MsgTo;$Subject;$Message;0;587;"a.user";"@!password@!")