tibrvTransport_CreateInbox()
Function
Declaration
tibrv_statustibrvTransport_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 |
|
Create an inbox on this transport. |
|
The program supplies a string buffer, and the function stores the new inbox subject string in that buffer. |
|
The number of bytes that the program has allocated to receive the new inbox subject string. |