Catalyst Internet Mail .NET

InternetMail.GetMessage Method (Byte[], Int32)

Retrieve the current message from the server and return the contents in a byte array.

[Visual Basic]
Overloads Public Function GetMessage( _
   ByVal buffer As Byte(), _
   ByRef length As Integer _
) As Boolean
[C#]
public bool GetMessage(
   byte[] buffer,
   ref int length
);

Parameters

buffer
A byte array that the message data will be stored in.
length
An integer value passed by reference which specifies the maximum number of bytes of data to read. This value cannot be larger than the size of the buffer specified by the caller. When the method returns, this parameter will be updated with the actual number of bytes copied into the array.

Return Value

This method returns a boolean value. If the method succeeds, the return value is true. If the method fails, the return value is false. To get extended error information, check the value of the LastError property.

Remarks

The GetMessage method is used to retrieve the current message from the server and copy it into a local buffer. 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.

See Also

InternetMail Class | SocketTools Namespace | InternetMail.GetMessage Overload List