4D Internet Commands v14

SMTP_Auth

Inicio

 
4D Internet Commands v14
SMTP_Auth

SMTP_Auth 


 

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

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)

 
PROPIEDADES 

Producto: 4D Internet Commands
Tema: IC Send Mail
Número 88851

 
HISTORIA 

Modificado: 4D Internet Commands 2003

 
ARTICLE USAGE

4D Internet Commands ( 4D Internet Commands v11.4)
4D Internet Commands ( 4D v13.2)
4D Internet Commands ( 4D Internet Commands v12.1)
4D Internet Commands ( 4D Internet Commands v14 R2)
4D Internet Commands ( 4D Internet Commands v14)
4D Internet Commands ( 4D Internet Commands v14 R3)
4D Internet Commands ( 4D Internet Commands v14 R4)