4D Doc Center : IMAP

Home

4D Internet Commands v14

IMAP_SetPrefs


IMAP_SetPrefs ( stripLineFeed ; msgFolder ) -> Function result

Parameter	Type	Description
stripLineFeed	Integer	0 = Do not strip LineFeeds, 1 = Strip LineFeeds, -1 = No Change
msgFolder	Text	Messages folder path ("" = no change)
Function result	Integer	Error code

Description

The IMAP_SetPrefs command sets the preferences for all IMAP commands.

stripLineFeed is an integer value specifying how LineFeed characters will be treated in saved messages. Most IMAP servers combine Carriage Return and Line Feed characters to indicate the end of a line. Macintosh applications prefer a carriage return only as the end-of-line character. This option lets users strip the linefeed character from their message text. A value of zero will leave retrieved messages in the format as stored on the IMAP server. A value of 1 will strip linefeed characters from retrieved messages. A value of -1 will leave this preference as it has been previously set. The default option is set to 1 and will automatically strip linefeeds found in messages.

msgFolder is a text value indicating the local pathname to a folder in which messages retrieved with the IMAP_Download command are stored by default.