POP3_Login

4D Internet Commands v16

POP3_Login


POP3_Login ( nomServidor ; nomUsuario ; contraseña ; aPOP ; pop3_ID {; paramSesion} ) -> resultado

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

Descripción

El comando POP3_Login conecta al usuario definido por nomUsuario y contraseña al servidor de correo POP3. Si aPOP vale 1, el mecanismo APOP (RFC#1321) se utiliza para la conexión. Si aPOP es cero o está vacío, la conexión se efectúa normalmente, con una contraseña en texto plano. pop3_Login devuelve un número de identificación para la conexión (pop3_ID) que los comandos posteriores deberán utilizar.

Atención: los servidores POP3 no fueron diseñados para ser accesibles de forma interactiva. Una vez conectado a un servidor, debe realizar las acciones necesarias y luego desconectarse del servidor tan pronto como sea posible. Entre las llamadas de POP3_Login y POP3_Logout, su procedimiento no debe participar en pantallas de usuario interactivo. Un servidor POP3 desconectará automáticamente todas las reuniones que no presenten actividad durante un período de tiempo determinado. De acuerdo con el RFC para POP3, el periodo de inactividad autorizado es de mínimo 30 minutos. Sin embargo, nuestra experiencia ha demostrado que la mayoría de servidores desconectan a los usuarios inactivos después de un período mucho más corto de tiempo.

Cada comando que interactúa con el servidor POP3 provoca un reinicio de su contador de inactividad. Si el servidor interrumpe la conexión antes de que haya llamado a POP3_Logout, todas las eliminaciones que haya realizado se cancelan.

nomServidor es el nombre o la dirección IP del servidor de correo POP3. 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 POP3. 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 POP3.

El parámetro aPOP es un valor entero que indica si el mecanismo APOP debe ser utilizado para la conexión. Pase 1 para utilizar el mecanismo APOP. Pase cero para efectuar la conexión con contraseña en texto plano. El valor por defecto es cero.

pop3_ID es una variable de tipo entero largo en la que se devuelve una referencia a la conexión que se acaba de establecer. La variable se utiliza en todos los comandos posteriores que realizan acciones relacionadas con esta sesión.

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

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

Ver también

POP3_Logout