Open topic with navigation

TIBCO Rendezvous® 8.7.0

# tibrvEventVectorCallback

Function Type

## Declaration

    typedef void (*tibrvEventVectorCallback) (
        tibrvMsg     messages[],
        tibrv_u32    numMessages);

## Purpose

Programs define functions of this type to process message vector events.

## Remarks

In the simplest arrangement, your callback function processes the messages in the array. When the callback function returns, the Rendezvous library deallocates the array.

If your application requires a more complex processing arrangement, it can detach individual messages, and pass them to other threads for processing. (If your program detaches a message, then it must also explicitly destroy it.)

It is illegal to pass the message array to a different thread for processing, or to use it as dynamically-allocated storage.

Notice that in contrast to tibrvEventCallback, this vector callback does not receive the listener event and the closure object as arguments. You can use tibrvMsg_GetEvent() and tibrvMsg_GetClosure() to get them from the individual message objects.

Parameter | Description
`messages` | The callback receives an array of inbound messages in this parameter.
`numMessages` | This parameter receives the number of messages in the array.

## See Also

tibrvMsg_Detach()

tibrvMsg_GetClosure()

tibrvMsg_GetEvent()

tibrvEvent_CreateVectorListener()

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO Rendezvous®

Copyright © 1997-2023. Cloud Software Group, Inc. All Rights Reserved.