4D Doc Center : POP3

4D v13.2

POP3_VerifyID


POP3_VerifyID ( pop3_ID ) -> Function result

Parameter	Type	Description
pop3_ID	Longint	Reference to a POP3 login
		0 = Connection has already closed
Function result	Integer	Error Code

Description

A POP3 server will automatically terminate sessions which do not show activity in a period of time determined by its administrator. Each command that interacts with the POP3 server forces a reset of the inactivity timer. The POP3_VerifyID command resets the inactivity time for the specified POP3 session without performing any other action. This allows the user to keep a session active if the possibility exists that the session may timeout.

When executed, the POP3_VerifyID command will verify the connection has not already been closed. If the session is still open the command will tell the POP3 server to reset the timeout counter for the session back to zero. If the connection has already closed, POP3_VerifyID will return the appropriate error and free memory used by the POP3 session, and return a zero value back to pop3_ID.

pop3_ID is a long integer reference to an open session created with POP3_Login.