POP3c_Authenticate()

Logs the user into the system (the POP3 server).

Files

pop3-c.h/pop3-c.c

Prototype

void  POP3c_Authenticate (NET_SOCK_ID   sock,
                          CPU_CHAR     *username,
                          CPU_CHAR     *pswd,
                          NET_ERR      *perr);

Arguments

sock

Socket ID returned by POP3c_Connect().

username

Username on the POP3 server, or NULL if not needed.

pswd

Password associated with the previous username, or NULL if not needed.

perr

Pointer to a variable that will hold the return error code from this function.


Returned Values

None.

Required Configuration

None.

Notes / Warnings

  • As stated in RFC #1939, Section ‘Basic Operation’, “Each argument may be up to 40 characters long”. Passing a NULL argument for either the username of the password result in the associate command not to be send to the server.

Example Usage

See Sample Application.