SMTP_SetPrefs

4D Internet Commands v16

SMTP_SetPrefs


SMTP_SetPrefs ( retornoLinea ; caracYcodif ; longLinea ) -> resultado

Parámetro	Tipo	Descripción
retornoLinea	Entero	1 = [por defecto] Añadir, 0 = No añadir, -1 = No cambiar
caracYcodif	Entero largo	Conjunto de caracteres del cuerpo del mensaje, encabezados y nombres de archivos adjuntos, así como también codificación del cuerpo (-1 = sin cambio)
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 a enviar utilizando los comandos SMTP. 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 Mac, 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. Al pasar un valor de cero en este parámetro se 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.

caracYcodif especifica el conjunto de caracteres utilizado en el cuerpo del mensaje, encabezados y nombres de archivos adjuntos a enviar, así como también la codificación a aplicar al cuerpo del mensaje, de acuerdo con los valores en la tabla abajo. Por ejemplo, “US-ASCII & 7 bit” (valor 2) significa que el conjunto de caracteres utilizado es el ASCII US, incluye sólo códigos ASCII estándar (0 a 127) que son comunes para Windows y Mac y 4D Internet Commands codificarán 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, el usuario debe asegurarse de 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.
Si no cambia, el tipo de contenido por defecto es 1.

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

Atención: el carácter € ("euro") no es parte de ISO-8859-1.

El parámetro longLinea especifica la longitud máxima de línea en el cuerpo del mensaje. Los comandos SMTP "fuerzan" el paso a la línea en el cuerpo del texto mediante la inserción de un retorno de carro/salto de línea después de la palabra más cercana de la longitud máxima de línea. Puede especificarse cualquier número, pero es preferible que las líneas no pasen de 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 conjuntoYcodificacion. 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 (los encabezados permanecen en su conjunto de caracteres por defecto):

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

 $err:=SMTP_Charset(0;1) //aplicar las preferencias

 $err:=SMTP_QuickSend("mymail.com";"myaddress";"destination";"El Euro €";"El símbolo Euro es €")

Ver también

SMTP_Charset
SMTP_GetPrefs