|
Summary
Extract message. This method has been deprecated. Use the ExtractMessageStart,
ExtractMessageData and ExtractMessageEnd methods to extract a message.
Syntax
| Boolean Extract (Src, Dest) |
Description
To extract a message, call the Extract method with the Src and Dest
parameters set. The Src parameter must be set to source path and filename and Dest
parameter must be set to the destination directory name.
The message header and body are extracted first and saved in the destination directory.
The OnExtract event will be fired to inform the application about the filename, encoding
type, content type, subtype and level. The FileName, Encoding, ContentType and Subtype
properties will be set with the appropriate values before the OnExtract event is fired.
If there are any attachments, they will be extracted and the OnExtract event will
contain the information. All encoded files will be decoded and then saved. For Partial
messages, the OnExtract message will be fired only when all the parts of the message have
been extracted and reassembled. An OnError event will occur to indicate only a part of the
message has been extracted.
If an error occurs, then the OnError event will be fired. The application should set a
flag in the OnError event, so that it can determine if the action was successful. In
addition, the application may want to display an error message in the OnError event to
inform the user of the error. Please check the reference page of the OnError event for a
complete listing of error codes.
The Extract method returns True if successful; otherwise, it returns False. Calling
this method is equivalent to setting the Action property to ACTION_EXTRACT.
Example
Result = Mime.Extract ("c:\temp\test.001",
"c:\temp")
If Result = True Then
MsgBox "Extracted message successfully", 64, "Sample Program"
End If
| 
