Previous

Next

Function xn_pop_client_ex

Function xn_pop_client_ex connects and authenticates with a POP3 server.

int xn_pop_client_ex(pop_context * context, 
                     BYTE        * pop_server_ip, 
                     char        * username, 
                     char        * password, 
                     WORD          port, 
                     DWORD         flags);

Parameters

context

Pointer to a pop_context structure allocated by the application. Applications do not need to set or retrieve any values in this structure.

pop_server_ip

The POP3 server's IP address in network byte order.

username

Username to log in to the POP3 server.

password

Password to log in to the POP3 server.

port

TCP port number to connect to in little endian format. If this parameter is 0, default value 110 for unencrypted and 995 for secure connections is selected.

flags

0 or POP_SECURE for a secure connection.

return value

Returns 0 if successful, otherwise SOCKET_ERROR. If an error occurred, call xn_getlasterror and xn_geterror_string to return the error value. Section Error Codes further describes each error.

Possible values for this function are:

This function connects to a POP3 server. The function xn_pop_QUIT needs to be called to close the connection.

If flag POP_SECURE is applied, this function requires an initialization of RTIP-32's SSL/TLS support.

POP3 Client

POP3 Configuration

Function xn_pop_client