Previous

Next

Function xn_pop_checkmail

Function xn_pop_checkmail obtains the number of messages in the mailbox and the size of the mail file.

struct _pop_info  { 
   int   num_messages; 
   long  mail_size; 
} pop_info; 

int xn_pop_checkmail(pop_context * context, pop_info * info);

Parameters

context

Pointer to the context of the current session. *context must have been initialized by xn_pop_client.

info

Pointer to the structure to receive the number and total size of messages available on the POP3 server.

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:

POP3 Client

Function xn_pop_client

Function xn_pop_mailinfo