Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.0 » UltraLite - C and C++ Programming » API Reference » UltraLite C++ API Reference » UltraLite_Connection_iface class


SendNotification function

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

  • event_name   identity for notification

  • parameters   parameters option list or NULL


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.


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

See also