SendNotification function

Synopsis
ul_u_long UltraLite_Connection_iface::SendNotification(
  const ULValue & queue_name,
  const ULValue & event_name,
  const ULValue & parameters
)
Parameters
  • queue_name   target queue name (or "*")

  • event_name   identity for notification

  • parameters   parameters option list or NULL

Remarks

Send a notification to all queues matching the given name.

This includes any such queue on the current connection. This call does not block. Use the special queue name "*" to send to all queues. The given event name does not need to correspond to any system or user-defined event; it is simply passed through to identify the notification when read and has meaning only to the sender and receiver. The parameters argument specifies a semicolon delimited name=value pairs option list. After the notification is read, the parameter values are read with GetNotificationParameter function.

Returns

The number of notifications sent (the number of matching queues).

See also