Post Office Protocol Vuser Functions (POP3) > Alphabetical List of Functions > pop3_retrieve_ex

pop3_retrieve_ex

Example: pop3_retrieve_ex Post Office Protocol Vuser Functions (POP3)

Retrieves messages from the POP3 server for a specific session.

long pop3_retrieve_ex( POP3 *pppop3, char *transaction, char *retrieveList, 
char *deleteFlag, [<Options>,] LAST );
pppop3 A session identifier.
transaction A transaction name for this step in quotes. To instruct VuGen not to create a transaction for this step, use a NULL string, "".
retrieveList The range of messages to retrieve. Use the one of the following formats: "RetrieveList=begin-end", "RetrieveList=Msga,Msgb,..,Msgn", or "RetrieveList=ALL"
deleteFlag If this flag is set to true (default), it instructs the server to delete the messages from the server after they are retrieved. Use the following format:
"DeleteMail=yes/no"
<Options> The following options are available:CreateParamForHeader: Create parameter to hold the values of headers. The value of the argument is a comma separated list of header names. The name of the parameter will have the following format: pop3_header_<HeaderName>_<MessageID>
The header name is case sensitive.ShowMail: If set to "yes", the messages will be displayed in the execution log. Default is "no". Use the format:
"ShowMail=yes/no"
SaveTo: Saves the data returned by the server to a parameter. Use the format:
"SaveTo=ParameterName"
SaveAs: Saves the retrieved messages to a file. Use the format:
"SaveAs=filename"
LAST A marker indicating the end of the argument list.

The pop3_retrieve_ex function retrieves messages from the POP3 server. You can specify a range or all of the messages. By default, it deletes the messages from the server after they are retrieved.

This function is for use with multiple sessions. For global sessions, use the pop3_retrieve function, which leaves out the session identifier.

Return Values

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

Parameterization

The following argument(s) can be parameterized with standard parameterization: retrieveList, deleteFlag