Topic Path: Pending > TIdIMAP4.UIDRetrieveEnvelopeRaw@String@TStringList

Retrieves SMTP envelope information for a message in the mailbox.

Message unique identifier to retrieve from the mailbox.
Storage for raw envelope data. 

Boolean - True on success.

UIDRetrieveEnvelopeRaw is a Boolean function used to retrieve the SMTP envelope information for the unique message identifier specified in AMsgUID, and to store the information in the TStrings instance specified in ADestList. 

UIDRetrieveEnvelopeRaw validates the unique message identifier (UID) in AMsgUID to ensure that it contains a valid value. An EIdNumberInvalid exception will be raised when the unique identifier is invalid. 

UIDRetrieveEnvelopeRaw requires that ConnectionState contain the value csSelected, indicating a mailbox has been successfully selected and authenticated. UIDRetrieveEnvelopeRaw can raise an EIdConnectionStateError exception if a mailbox has not been selected and/or authenticated for the current user. 

UIDRetrieveEnvelopeRaw calls SendCmd using the IMAP4 FETCH command and arguments constructed from the value in AMsgUID and the IMAP4 fetch data flags required for the operation. UIDRetrieveEnvelopeRaw reads the multi-line response from the IMAP4 server, and verifies that the initial response matches the command issued using SendCmd. When they are the same, UIDRetrieveEnvelopeRaw extracts the SMTP headers from the response and parses the header for storage in ADestList. 

Use UIDRetrieveEnvelope to retrieve and store message envelope data into a specified TIdMessage argument. 

Use Retrieve or RetrieveEnvelopeRaw to retrieve and store message envelope data for a message identified by its relative message number.

ConnectionState UIDRetrieveEnvelope RetrieveEnvelopeRaw RetrieveEnvelope RetrieveEnvelopeRaw EIdNumberInvalid EIdConnectionStateError

Copyright 1993-2006, Chad Z. Hower (aka Kudzu) and the Indy Pit Crew. All rights reserved.
Post feedback to the Indy Docs Newsgroup.