4D Doc Center : SMTP

4D v13.2

SMTP_QuickSend


SMTP_QuickSend ( nomServidor ; msgDe ; msgA ; asunto ; mensaje {; paramSesion}{; puerto}{; nomUsuario ; contrasena} ) -> resultado

Parámetro	Tipo	Descripción
nomServidor	Cadena	Nombre o dirección IP del servidor
msgDe	Texto	Dirección electrónica o Lista de direcciones
msgA	Texto	Dirección electrónica o Lista de direcciones
asunto	Texto	Asunto del mensaje
mensaje	Texto	Mensaje
paramSesion	Entero largo	1 = Utilizar SSL, 0 se omite = No utilizar SSL
puerto	Entero largo	Número de puerto a utilizar
nomUsuario	Texto	Nombre de usuario para la autenticación
contrasena	Texto	Contraseña para la autenticación
resultado	Entero	Código de error

Descripción

El comando SMTP_QuickSend permite crear y enviar un mensaje con un solo comando. Si requiere un mayor control sobre el mensaje o si el mensaje es más complejo, utilice el comando SMTP_New.

nomServidor contiene el nombre o la dirección IP del servidor SMTP que se encargará de la distribución del mensaje.

msgDe contiene una o más direcciones electrónicas completas indicando quien envió el mensaje originalmente. Todas las direcciones que figuran en el encabezado De son visibles para todos los destinatarios del mensaje.

msgA contiene una o más direcciones electrónicas completas. Las direcciones identificadas en el encabezado msgA reciben una copia original del mensaje. Cada destinatario del mensaje puede ver las otras direcciones electrónicas a las cuales fue enviado el mensaje.

asunto es un valor texto que describen de forma concisa el tema tratado en detalle por el cuerpo del mensaje.

Atención: por lo general, el asunto del mensaje no debe contener caracteres con signos diacríticos (por ejemplo é, ö, etc.) Sin embargo, si desea utilizar caracteres "extendidos", consulte las descripciones de los comandos SMTP_SetPrefs y SMTP_Charset.

mensaje es un valor texto que contiene el cuerpo del mensaje. Por razones históricas, el tamaño del mensaje está limitado a 32 KB.

El parámetro opcional paramSesion permite activar el protocolo SSL para la conexión:

Si pasa 0 u omite este parámetro, el mensaje se enviará en modo estándar no seguro. Si el servidor propone una actualización a SSL/TLS después de la autenticación, la báscula se efectúa automáticamente (funcionamiento del SSL/TLS en modo explícito).
Si pasa 1, el envío del mensaje se efectúa en SSL (modo síncrono),
Si pasa 0 u omite este parámetro, la conexión se efectúa en modo estándar, no seguro.
Si pasa 2, el mensaje se enviará en modo estándar pero sin soporte de actualización en SSL/TLS.

El parámetro opcional puerto especifica el número de puerto SMTP a utilizar para la conexión con el servidor. Los valores utilizados con más frecuencia son:

25 = puerto STMP estándar no seguro (puerto por defecto si el parámetro se omite)
465 = puerto SMTPS (SSL/TLS)
587 = puerto STMP estándar (seguro); pase este puerto para conexiones con un servidor MS Exchange (modo explícito).

Los parámetros opcionales nomUsuario y contrasena se utilizan para autenticar el remitente con el servidor de correo. Estos parámetros deben pasarse en conjunto. Note que el modo de autenticación más seguro soportado pro el servidor será el utilizado (como el modo por defecto del comando SMTP_Auth).

Ejemplo 1

Ejemplo de uso de este comando:

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

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

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

 $Subject:="Informes de ventas"

 $Message:="¿Podría enviarme el informe de ventas de enero de 2009? Gracias."

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

 If($Error#0)

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

 End If

Ejemplo 2

Ejemplo de utilización del comando para un envío de mensaje seguro vía un 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@!")