SendNotification function

Send a notification to all queues matching the given name.

Syntax
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

Returns

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

Remarks

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.

See also