Open topic with navigation

TIBCO Rendezvous® 8.8.0

# tibrvTransport_CreateInbox()

Function

## Declaration

    tibrv_status tibrvTransport_CreateInbox(
        tibrvTransport       transport,
        char*                subjectString,
        tibrv_u32            subjectLimit);

## Purpose

Create a unique inbox subject name.

Warning | This function is the only legal way for programs to create inbox subject names.

## Remarks

This function creates inbox names that are unique throughout the transport scope.

| • | For network transports, inbox subject names are unique across all processes within the local router domain—that is, anywhere that direct multicast contact is possible. The inbox name is not necessarily unique outside of the local router domain.

| • | For the intra-process transport, inbox names are unique across all threads of the process.

This function creates only the unique name for an inbox; it does not begin listening for messages on that subject name. To begin listening, pass the inbox name as the `subject` argument to `tibrvEvent_CreateListener(). The inbox name is only valid for use with the same transport that created it. When calling tibrvEvent_CreateListener(), you must pass the same transport object that created the inbox subject name.`

Remember that other programs have no information about an inbox subject name until the listening program uses it as a reply subject in an outbound message.

Programs can overwrite or free the `subjectString` storage at any time.

Use inbox subject names for delivery to a specific destination. In the context of a network transport, an inbox destination specifies unicast (point-to-point) delivery.

Rendezvous routing daemons (`rvrd`) translate inbox subject names that appear as the send subject or reply subject of a message. They do not translate inbox subject names within the data fields of a message.

Parameter | Description
`transport` | Create an inbox on this transport.
`subjectString` | The program supplies a string buffer, and the function stores the new inbox subject string in that buffer.
`subjectLimit` | The number of bytes that the program has allocated to receive the new inbox subject string.

## See Also

`tibrvEvent_CreateListener()`

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.