4D Doc Center : SMTP

4D Internet Commands v14

SMTP_SetPrefs


SMTP_SetPrefs ( retornoLinea ; tipoCuerpo ; longLinea ) -> resultado

Parámetro	Tipo	Descripción
retornoLinea	Entero	1 = [por defecto] Añadir, 0 = No añadir, -1 = No cambiar
tipoCuerpo	Entero	Body-Content-Type (1 = [por defecto] Detección auto, -1 = Ninguna modificación)
longLinea	Entero largo	Longitud de línea máxima (0 = [por defecto] Detección auto, -1 = Ninguna modificación)
resultado	Entero	Código de error

Descripción

El comando SMTP_SetPrefs define las preferencias de los mensajes SMTP a enviar. El comando tiene un alcance global e interproceso y afecta a todos los mensajes posteriores creados con los comandos SMTP. Las opciones configurables afectan el formato de un mensaje que se envía a un servidor SMTP con los comandos SMTP_QuickSend o SMTP_Send. La configuración de las preferencias tiene un alcance interprocesos y afecta la creación de correos en cualquier proceso 4D.

Los servidores SMTP requieren la combinación de caracteres retorno de carro/retorno de línea (CR/LF) para indicar el final de una línea. Esto difiere de la mayoría de las aplicaciones Macintosh, que consideran un retorno de carro como un marcador de fin de línea o de párrafo.

retornoLinea es un valor entero que especifica cómo manejar los retornos de carro en el cuerpo de un mensaje. Pasar un valor de cero en este parámetro deja el texto del cuerpo del mensaje intacto, lo que permite al desarrollador controlar sus propias adiciones de retornos de línea. Un valor de 1 (parámetro por defecto), reemplaza automáticamente todos los retorno de carro/retorno línea por retornos de carro solos. Un valor de -1 deja el valor actual de la preferencia intacto. Si no está seguro de qué opción elegir, debe elegir 1, el valor por defecto.

tipoCuerpo especifica el conjunto de caracteres usado en el cuerpo del mensaje a enviar (Body-Content-Type), así como la codificación a aplicar al cuerpo del mensaje (Content-Transfer-Encoding), de acuerdo con los valores de la tabla de abajo. Por ejemplo, "US-ASCII de 7 bits" (valor 2) significa que el conjunto de caracteres utilizado es el ASCII US (uso de los 128 primeros caracteres de la tabla ASCII exclusivamente) y que 4D CI codifica el cuerpo del mensaje utilizando la codificación de 7 bits. Tenga en cuenta que el comando SMTP_SetPrefs no convierte el cuerpo del mensaje utilizando el conjunto caracteres especificado, si es necesario el usuario debe asegurar la conformidad del conjunto de caracteres. Si desea convertir el conjunto de caracteres utilizado en un mensaje, consulte la descripción del comando SMTP_Charset.
Por defecto, este parámetro tiene el valor 1, los comandos SMTP detectan automáticamente los parámetros apropiados en función del contenido del cuerpo del mensaje.

-1	Ninguna modificación
0	Aplicación y binario; sin codificación
1	Valor por defecto; selección de "US-ASCII & 7 bits" o "ISO-8859-1 & quotable-printable", en función del contenido del mensaje.
2	US-ASCII & 7 bits
3	US-ASCII & quotable-printable
4	US-ASCII & base64
5	ISO-8859-1 & quotable-printable
6	ISO-8859-1 & base64
7	ISO-8859-1 & 8 bits
8	ISO-8859-1 & binario
9	Reservado
10	ISO-2022-JP (Japonés) & 7 bit
11	ISO-2022-KR (Coreano) & 7 bit
12	ISO-2022-CN (Tradicional y Chino simplificado) & 7 bit
13	HZ-GB-2312 (Chino simplificado) & 7 bit
14	Shift-JIS (Japonés) & base64
15	UTF-8 & quoted-printable
16	UTF-8 & base64

El parámetro longLinea especifica la longitud máxima de línea en el cuerpo del mensaje. Los comandos SMTP "fuerzan" la nueva línea en el texto mediante la inserción de un retorno de carro/salto de línea después de la palabra más cercana antes de la longitud máxima de línea. Puede especificarse cualquier número, pero se recomienda que la longitud de las líneas no supere los 80 caracteres. Un valor de -1 deja el valor actual intacto.

El valor por defecto del parámetro longLinea es cero. Un valor de cero hará que los comandos SMTP utilicen los valores recomendados especificados en las definiciones RFC para tipoCuerpo. Si el parámetro longLinea vale cero, el ajuste se realizará con base en la siguiente tabla:

Tipo de cuerpo	Pasa a la línea
Base64	76
Quoted-Printable	76
Otros…	no pasar a la línea

El ajuste de línea es muy recomendable ya que muchos sistemas y programas de correo tienen problemas para manejar mensajes con líneas de longitud ilimitada. Además, tenga en cuenta que el correo a menudo viaja a través de una serie de sistemas antes de llegar a su destino final y cualquier equipo a lo largo de la ruta de entrega puede rechazar un mensaje si no es capaz de manejar el formato del mensaje.

Ejemplo

El siguiente código envía un mensaje en UTF-8 codificado en quotedprintable:

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

 $err:=SMTP_QuickSend(...)