Open topic with navigation

TIBCO Rendezvous® 8.8.0

# tibrvcmEvent_CreateListener()

Function

## Declaration

    tibrv_status tibrvcmEvent_CreateListener(
        tibrvcmEvent*           cmListener,
        tibrvQueue              queue,
        tibrvcmEventCallback    callback,
        tibrvcmTransport        cmTransport,
        const char*             subject,
        const void*             closure);

## Purpose

Listen for messages that match the subject, and request certified delivery when available.

Parameter | Description
`cmListener` | For each inbound message, place this listener event on the event queue. The program supplies a location, and the function stores the new listener object in that location. The event object remains valid until the program explicitly destroys it.
`queue` | For each inbound message, place the listener event on this event queue.
`callback` | On dispatch, process the event with this callback function.
`cmTransport` | Listen for inbound messages on this certified delivery transport.
`subject` | Listen for inbound messages with subjects that match this specification. Wildcard subjects are permitted. The empty string is not a legal subject name.
`closure` | Store this closure data in the event object.

## Activation and Dispatch

Details of listener event semantics are identical to those for ordinary listeners; see Activation and Dispatch.

## Inbox Listener

To receive unicast (point-to-point) messages, listen to a unique inbox subject name. First call tibrvTransport_CreateInbox() to create the unique inbox name; then call tibrvcmEvent_CreateListener() to begin listening. Remember that other programs have no information about an inbox until the listening program uses it as a reply subject in an outbound message.

## See Also

tibrvcmEvent

tibrvcmTransport_Destroy()

tibrvEvent_GetListenerSubject()

tibrvTransport_CreateInbox()

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-2025. Cloud Software Group, Inc. All Rights Reserved.