CreateNotificationQueue function

Create an event notification queue for this connection.

Syntax
bool UltraLite_Connection_iface::CreateNotificationQueue(
  const ULValue & name,
  const ULValue & parameters
)
Parameters
  • name   Name for new queue.

  • parameters   creation parameters; currently unused, set to NULL.

Remarks

Queue names are scoped per-connection, so different connections can create queues with the same name. When an event notification is sent, all queues in the database with a matching name receive (a separate instance of) the notification. Names are case insensitive. A default queue is created on demand for each connection when calling RegisterForEvent function if no queue is specified. This call fails with an error if the name already exists or isn't valid.

See also