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.