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

 

GetNotification function

Synopsis
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

Remarks

Read an event notification.

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.

Returns

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

See also