4D v13.2

POP3_Login

Home

 
4D v13.2
POP3_Login

POP3_Login 


 

POP3_Login ( hostName ; userName ; password ; aPOP ; pop3_ID {; sessionParam} ) -> Function result 
Parameter Type   Description
hostName  String in Host Name or IP address of the POP3 mail server
userName  String in User name
password  String in Password
aPOP  Integer in 0 = Cleartext Login, 1 = APOP Login
pop3_ID  Longint in Reference to this POP3 login
sessionParam  Longint in 1 = Use SSL, 0 or omitted = Do not use SSL
Function result  Integer in Error Code

The POP3_Login command logs the user into the POP3 mail server with the given userName and password. If aPOP is 1 then the APOP mechanism (RFC#1321) is used to login. If aPOP is zero or not given then a normal cleartext password login is performed. The particular login is given a reference (pop3_ID) which subsequent commands can refer to.

Warning: POP3 servers were not designed to be accessed in an interactive fashion. Once you have logged in to a server you should perform whatever actions are needed and then log out of the server as soon as possible. Between your calls of POP3_Login and POP3_Logout, your procedure should not sit in any user-interactive screen. A POP3 server will automatically disconnect any sessions which do not show activity for a certain period of time. According to the RFC for POP3, the inactivity timer is supposed to be a minimum of 30 minutes. However, our experience has shown that most servers force inactive clients out after a much shorter period of time.

Each command that interacts with the POP3 server will force a reset of your inactivity timer. In the event that the server aborts your connection before you have issued a POP3_Logout call, any deletions you had performed would be rolled back.

hostName is the host name or IP address of the POP3 mail server. It is recommended that the host name be used, but if needed an IP address can be used.

userName is the user's name on the POP3 mail server. The userName should not contain the domain. For example, for the address "jack@4d.com", userName would be just "jack".

password is the password for userName on the POP3 mail server.

aPOP is an integer value indicating whether the APOP mechanism is used to login. A value of 1 will use the APOP mechanism. A zero value will perform a cleartext password login. The default value is zero.

pop3_ID is a long integer variable into which is returned a reference to the session just established. The variable will be used in all subsequent commands which perform actions related to this session.

The optional sessionParam parameter enables the SSL protocol for a connection:

  • If you pass 1, the connection to the POP3 server will be made in SSL (synchronous mode),
  • If you pass 0 or omit this parameter, the connection will be made in standard, non-secure mode.

 
PROPERTIES 

Product: 4D
Theme: IC POP3 Review Mail
Number: 88968

 
INDEX

Alphabetical list of commands

 
HISTORY 

Created: 4D Internet Commands 6.5
Modified: 4D Internet Commands v12.1

 
SEE ALSO 

POP3_Logout