Retrieve a message from the server and store it in a local
file.
Syntax
object.StoreMessage( MessageNumber,
FileName )
Remarks
The StoreMessage method retrieves a message from the
server and stores it in a file on the local system. The contents of
the message is stored as a text file, using the specified file
name. This method will cause the current thread to block until the
message transfer completes, a timeout occurs or the transfer is
canceled. During the transfer, the OnProgress event will
fire periodically, enabling the application to update any user
interface objects such as a progress bar.
- MessageNumber
- Number of message to retrieve. This value must be greater than
zero. The first message in the mailbox is message number one.
- FileName
- Pointer to a null-terminated string which specifies the file
that message is to be stored in. If an empty string is passed as an
argument, the message is copied to the system clipboard.
Return Value
A value of zero is returned if the method was successful.
Otherwise, a non-zero error code is returned which indicates the
cause of the failure.
See Also
GetMessage Method, OpenMessage Method
|