4D Doc Center : SMTP

4D Internet Commands v14

SMTP_Auth


SMTP_Auth ( smtp_ID ; nomUsuario ; contraseña {; autMod} ) -> resultado

Parámetro	Tipo	Descripción
smtp_ID	Entero largo	Referencia del mensaje
nomUsuario	Cadena	Nombre del usuario para la autenticación SMTP
contraseña	Cadena	Contraseña para la autenticación SMTP
autMod	Entero	Modo de autenticación a utilizar: 0 o se omite = Modo definido por el servidor 1= PLAIN, 2 = LOGIN, 3 = CRAM-MD5
resultado	Entero	Código de error

Descripción

El comando SMTP_Auth permite el envío del mensaje referenciado por smtp_ID cuando un mecanismo de autenticación es requerido por el servidor SMTP. Este tipo de autenticación es requerida por algunos servidores SMTP con el fin de reducir el riesgo de que los mensajes se falsifiquen o que la identidad del remitente sea usurpada, particularmente con el fin de enviar spam.

Este comando se puede utilizar si la autenticación es necesaria o no, ya que sólo se ejecuta si nomUsuario y contraseña no son cadenas vacías.

smtp_ID es la referencia entero largo de un mensaje electrónico creado con el comando SMTP_New.

nomUsuario es el nombre del usuario en el servidor SMTP. El parámetro nomUsuario no debe contener el dominio. Por ejemplo, para la dirección "jack@4d.com", el nomUsuario es "Jack".

contraseña es la contraseña para nomUsuario en el servidor SMTP.

Nota: si nomUsuario y/o contraseña son cadenas vacías, el comando SMTP_Auth no se ejecuta.

El parámetro opcional autMod permite "forzar" el modo de autenticación utilizado. Puede pasar 0, 1, 2 ó 3 en este parámetro:

Si pasa 0 (cero), el modo de autenticación utilizado por el comando SMTP_Auth será el modo más seguro soportado por el servidor (CRAM-MD5, LOGIN luego PLAIN),
Si pasa 1, el método de autenticación utilizado será PLAIN,
Si pasa 2, el método de autenticación utilizado será LOGIN,
Si pasa 3, el método de autenticación utilizado será CRAM-MD5.
Si omite autMod, por defecto se utiliza el valor 0. Si el método de autenticación solicitado por este parámetro no es compatible con el servidor SMTP, se devuelve un error.

Ejemplo

Este ejemplo permite enviar un mensaje con o sin autenticación, en función del contenido de campos especificados almacenados en la base 4D:

C_INTEGER($vError)

 C_LONGINT($vSmtp_id)

 C_STRING(30;$vAuthUserName;$vAuthPassword)

 

 $vError:=SMTP_New($vSmtp_id)

 $vError:=SMTP_Host($vSmtp_id;"wkrp.com")

 $vError:=SMTP_From($vSmtp_id;"herb_tarlick@wkrp.com")

 $vError:=SMTP_Subject($vSmtp_id;"Are you there?")

 $vError:=SMTP_To($vSmtp_id;"Dupont@wkrp.com")

 $vError:=SMTP_Body($vSmtp_id;"Podemos reunirnos?")

 

  ` Los campos se introducen si el servidor utiliza un mecanismo

  ` de auntenticación. De lo contrario, se devuelven las cadenas vacías.

 $vAuthUserName:=[Account]AuthUser

 $vAuthPassword:=[Account]AuthPass

 

 $vError:=SMTP_Auth($vSmtp_id;$vAuthUserName;$vAuthPassword)

 $vError:=SMTP_Send($vSmtp_id)

 $vError:=SMTP_Clear($vSmtp_id)