Skip navigation links
3.2.1.6 ndb_logevent_get_latest_error() »
Section Navigation      [Toggle]

3.2.1.5. ndb_logevent_get_next()

Description.  This function is used to retrieve the next log event, using the event's data to fill in the supplied ndb_logevent structure.

Signature.  

int ndb_logevent_get_next
    (
      const NdbLogEventHandle handle,
      struct ndb_logevent*    logevent,
      unsigned                timeout
    )

Parameters.  Three parameters are expected by this functions:

  • An NdbLogEventHandle

  • A pointer to an ndb_logevent data structure

  • The number of milliseconds to wait for the event before timing out; passing 0 for this parameter causes the function to block until the next log event is received

Return value.  The value returned by this function is interpreted as follows:

  • > 0: The event exists, and it data was retrieved into the logevent

  • 0: A timeout occurred while waiting for the event (more than timeout milliseconds elapsed)

  • < 0: An error occurred.

If the return value is less than or equal to zero, then the logevent is not altered or affected in any way.