IMAP_Login

4D Internet Commands v16

IMAP_Login


IMAP_Login ( nomServidor ; nomUsuario ; contraseña ; imap_ID {; paramSesion} ) -> resultado

Parámetro	Tipo	Descripción
nomServidor	Cadena	Nombre o dirección IP del servidor de correo IMAP
nomUsuario	Cadena	Nombre del usuario
contraseña	Cadena	Contraseña
imap_ID	Entero largo	Referencia a esta conexión IMAP
paramSesion	Entero largo	1 = Use SSL, 0 se omite = No utilizar SSL
resultado	Entero	Código de error

Descripción

El comando IMAP_Login conecta al usuario al servidor de correo IMAP con el nombre de usuario y contraseña dados.

IMAP_Login devuelve un número de identificación específico para la conexión (imap_ID) al cual los comandos IMAP posteriores pueden referirse.

La conexión se cierra con el comando IMAP_Logout o cuando el contador de inactividad del servidor IMAP supera el timeout.

nomServidor es el nombre o la dirección IP del servidor de correo IMAP. Se recomienda utilizar el nombre del servidor, si es necesario, puede utilizar una dirección IP.

nomUsuario es el nombre del usuario del servidor de correo IMAP. 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 correspondiente a nomUsuario en el servidor de correo IMAP.

imap_ID es una variable de tipo entero largo en la que se devuelve una referencia a la conexión que se acaba de establecer. Este parámetro debe pasarse a una variable 4D para aceptar los resultados devueltos. La variable se utiliza en todos los comandos posteriores que realizan acciones relacionadas con esta sesión. Si IMAP_Login, imap_ID toma el valor cero.

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

Si pasa 1, la conexión al servidor IMAP 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.

Ejemplo

Esta es una secuencia típica de conexión:

 $ErrorNum:=IMAP_Login(vHost;vUserName;vUserPassword;vImap_ID;1)

 If($ErrorNum =0)

    C_TEXT(vCapability)

    $ErrorNum:=IMAP_Capability(vImap_ID;vCapability))

  ` Los comandos IMAP utilizan el parámetro vImap_ID

 End if

 $ErrorNum:=IMAP_Logout(vImap_ID)

Ver también

IMAP_Logout
IMAP_VerifyID