pop3_free

Frees the POP3 server.

void pop3_free();

The pop3_free function frees the POP3 server and cancels all of the pending commands.

This function is for use with global sessions. For multiple sessions, use the pop3_free_ex function, which allows you to specify a session identifier.

Return Values

If this function succeeds, it returns LR_PASS. Otherwise, it returns LR_FAIL.

Parameterization

You cannot use standard parameterization for any arguments in this function.

Example

In the following example, the pop3_free function frees up the POP3 server.

...

// Logon to the POP3 server

pop3_logon( "Login", "
        URL=pop3://user0004t:my_pwd@techno.merc-int.com", 
        LAST );

// Retrieve all messages on the server without deleting any of them

pop3_retrieve("POP3", "RetrieveList=ALL", "DeleteMail=false", LAST );

// Free the server

pop3_free();

...