imap_set_max_param_len

Sets the maximum buffer size to store a parameter value.

int imap_set_max_param_len( char *size );

Use imap_set_max_param_len to set the maximum size of the buffer used to store a message as a parameter. It is invoked before the function which saves the message to a parameter (imap_fetch and imap_search).

For sessions, use imap_set_max_param_len_ex.

Return Values

On success, returns actual buffer size that was set. Otherwise, returns 0.

Parameterization

All arguments of this function of the type char, can be parameterized with standard parameterization.

Example

The following example saves the message to a parameter "Message" using the saveto parameter. imap_set_max_param_len indicates the size of the buffer to hold the message.

imap_set_max_param_len( "16384");
imap_fetch_ex(&imap2, "FetchMessages", "Mode=UID", 
               "Fetch=3 (UID RFC822.SIZE BODY[]<0.6144>)", 
               "saveto=Message", ENDITEM, LAST );
lr_log_message("Message = %s", lr_eval_string("<Message>"));