GetNotification function

Read an event notification.

Syntax
ULValue UltraLite_Connection_iface::GetNotification(
  const ULValue & queue_name,
  ul_u_long wait_ms
)
Parameters
  • queue_name   queue to read or NULL for default connection queue

  • wait_ms   time to wait (block) before returning

Returns

The name of the event read or empty string on error.

Remarks

This call blocks until a notification is received or until the given wait period expires. To wait indefinitely, pass UL_READ_WAIT_INFINITE for wait_ms. To cancel a wait, send another notification to the given queue or use CancelGetNotification function. After reading a notification, use ReadNotificationParameter() to retrieve additional parameters by name.

See also