RetrieveHeaders Method

Retrieves headers for a message specified by MessageNumber .

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int RetrieveHeaders();

Unicode (Windows)
INT RetrieveHeaders();

- (void)retrieveHeaders;

#define MID_SPOP_RETRIEVEHEADERS 15

IPWORKSSMIME_EXTERNAL int IPWORKSSMIME_CALL IPWorksSMIME_SPOP_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

Calling this method will retrieve the headers for the message specified by the MessageNumber property. The message headers will be provided by the Header event and also stored in the MessageHeaders property.

Example (Connect and Retrieve Message Headers)

POPControl.MailServer = "MyPOPServer"
POPControl.User = "username"
POPControl.Password = "password"
POPControl.Connect()

POPControl.MessageNumber = 1
POPControl.RetrieveHeaders()

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)