DispatchNotification

The DispatchNotificationfunction indicates whether a message was successfully queued.

Syntax

  Copy codeCopy code 
bool DispatchNotification(
  string methodName,
  string value,
  string value,...
);

Parameters

methodName

The name of a method in the managed code application that will receive the dispatched message and process it.

Value

A context-specific parameter that is of type bool, int, float, string, or any type that can be cast to a string, or whose value is null.

Value,...

Optional. One or more additional context-specific parameters that are of type bool, int, float, string, or any type that can be cast to a string, or whose value is null.

Return values

Returns true if the message was successfully queued; otherwise, it is false .

Remarks

The DispatchNotificationfunction is a one-way remote procedure call alternative to the Dispatch function. The DispatchNotificationfunction is intended for use when you must call managed code outside of the scope of a transaction, or when the caller does not care about reliability. The function assembles a packet containing the context-specific information to pass to the managed code application, and queues it for delivery. Because the procedure call is one-way, SPL script execution continues, making it necessary to proxy or dispatch the message.

Note Note

The DispatchNotificationfunction cannot be called after the message has been proxied or dispatched.

Use the DispatchNotificationfunction when the following conditions apply:

  • The application will not alter the message.

  • Routing is independent of application execution.

  • The application needs responses but not requests.

For example, use the DispatchNotificationfunction with applications that collect metrics, applications that report response errors, or applications that trigger other applications.