4D v13.2

MSG_GetHeaders

Home

 
4D v13.2
MSG_GetHeaders

MSG_GetHeaders 


 

MSG_GetHeaders ( fileName ; offset ; length ; headerText ) -> Function result 
Parameter Type   Description
fileName  Text in Filename (path defaults to message folder)
offset  Longint in Starting offset into headers (0 = start of header)
length  Longint in Number of characters
headerText  Text in Header text (removes linefeeds if Prefs ON)
Function result  Integer in Error Code

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.

 
PROPERTIES 

Product: 4D
Theme: IC Downloaded Mail
Number: 88953

 
INDEX

Alphabetical list of commands

 
HISTORY 

Modified: 4D Internet Commands 6.8.1

 
SEE ALSO 

MSG_MessageSize
MSG_SetPrefs
POP3_SetPrefs