|
Summary
Send additional header information. This event has been deprecated. Additional header
information can be set in the OnSetHeader event.
Description
The OnInformation event occurs in response to setting the Action property to
ACTION_CREATE, calling the Create or CreateX method. Additional header information may be
sent in this event. Applications may want to add specific information in the headers such
as an "X-Mailer" field. Such fields can be sent using this event.
This event must be processed even if the application does not have additional header
fields to be sent. To indicate the end of the additional headers set Buffer to an
empty string and Length to 0. Otherwise fill the Buffer string and set the Length
parameter to the length of the buffer. This information will be used inside the message
header.
In some environments, such as Visual J++, the new value assigned to the Buffer
parameter can not be successfully retrieved by the control. In these cases set UseProperty
to True, and assign data to the SendData property instead of the Buffer parameter.
The UseProperty property must be set to True before the attempting to create a message. In
this case treat the SendData property exactly as you would the Buffer parameter. If
UseProperty is True the Length parameter will be ignored.
To abort the create message, set the Action property to ACTION_ABORT (or call the Abort
method) during this event. The action in progress will be canceled and no further such
events will occur.
Example
Sub Mime_OnInformation (Buffer As String, Length As
Integer)
Buffer = ""
Length = 0
End Sub
|