MSG_GetHeaders

4D - Documentation   Français   English   German   Japanese   4D Internet Commands, Theme List   4D Internet Commands, Alphabetical List   Back   Previous   Next

version 6.8.1 (Modified)


MSG_GetHeaders (fileName; offset; length; headerText) Integer

ParameterTypeDescription
fileNameTextFilename (path defaults to message folder)
offsetLongintStarting offset into headers (0 = start of header)
lengthLongintNumber of characters
headerTextTextHeader text (removes linefeeds if Prefs ON)
Function resultIntegerError Code

Description

The MSG_GetHeaders command returns the raw text of the entire header section of the message. The header portion of a POP3 message is defined as the text from the beginning of the message to the first occurrence of two consecutive carriage return/line feed sequences.

fileName is the name of the file or the full path of the file of which to extract the header. If only a fileName is given, the path will default to the folder set by POP3_SetPrefs or MSG_SetPrefs (see Compatibility note). If no folder has been specified, the path will default to the folder containing the structure of the database (with 4D single-user) or to the 4D Client folder (with 4D Server).

offset is the character position within the source header information at which to begin the retrieval.

length is the number of characters to return. The length of the header section can be determined with MSG_MessageSize.

headerText receives the text of the header. This parameter takes the stripLineFeed parameter set by POP3_SetPrefs or MSG_SetPrefs into account.

Compatibility note (version 6.8.1): If the MSG_SetPrefs command is not used, the POP3_SetPrefs msgFolder parameter will be used; if MSG_SetPrefs is used, the POP3_SetPrefs msgFolder parameter is ignored.

See Also

MSG_MessageSize, MSG_SetPrefs, POP3_SetPrefs.


4D - Documentation   Français   English   German   Japanese   4D Internet Commands, Theme List   4D Internet Commands, Alphabetical List   Back   Previous   Next