Chameleon and Iguana Plugin C# Class Libraries

DestinationMessageReceivedEventOutputs Class

This class is used to send response data from MessageReceived event handlers back to Iguana.

For a list of all members of this type, see DestinationMessageReceivedEventOutputs Members.

System.Object
   iNTERFACEWARE.Iguana.Plugin.DestinationMessageReceivedEventOutputs

[Visual Basic]
Public Class DestinationMessageReceivedEventOutputs
[C#]
public class DestinationMessageReceivedEventOutputs

Thread Safety

Public static (Shared in Visual Basic) members of this type are safe for multithreaded operations. Instance members are not guaranteed to be thread-safe.

Remarks

Destination plugins are provided with an instance of this class as an argument to their MessageReceived event handler. The event handler uses the properties and methods of the provided instance to craft a suitable response to send back to Iguana. After the event handler returns, the response is sent back to Iguana.

At a minimum, the event handler should set the MessageProcessedFlag property to true to indicate to Iguana that the message was received and processed by the plugin. Setting this property to false will simply result in Iguana logging a generic error message; it will not result in Iguana resending the message or stopping the channel. Plugins can achieve more sophisticated and precise error handling using the properties and methods described below.

If the event handler is unable to complete processing in a timely fashion, it should use the ResendMessageFlag and ResendMessageDelay properties to request that Iguana resend the message. This ensures that Iguana does not time-out the connection to the plugin due to inactivity. The exact duration of the time-out is determined by the Plugin Time field value configured for the To Plugin channel component to which the plugin is connected.

The plugin event handler may request that the Iguana channel be stopped via the StopChannelFlag, StopChannelErrorFlag and StopChannelReason properties.

The plugin event handler may add log messages to Iguana's logs using the AddErrorLogMessage, AddWarningLogMessage, AddInfoLogMessage and AddDebugLogMessage methods.

Requirements

Namespace: iNTERFACEWARE.Iguana.Plugin

Assembly: IGC_dotnet (in IGC_dotnet.dll)

See Also

DestinationMessageReceivedEventOutputs Members | iNTERFACEWARE.Iguana.Plugin Namespace