A destination is where an application sends messages, or it is a source from which an application receives messages, or both.
xms::PropertyContext | +----xms::Destination
For a list of the XMS defined properties of a Destination object, see Properties of Destination.
Constructor | Description |
---|---|
Destination | Create a destination using the specified destination type and name. |
Destination | Create a destination using the specified uniform resource identifier (URI). |
Destination(const xmsDESTINATION_TYPE destinationType, const String & destinationName);
Create a destination using the specified destination type and name.
For a destination that is a queue, this constructor does not create the queue in the messaging server. You must create the queue before an application can call this constructor.
Destination(const String & URI);
Create a destination using the specified uniform resource identifier (URI). Properties of the destination that are not specified by the URI take the default values.
For a destination that is a queue, this constructor does not create the queue in the messaging server. You must create the queue before an application can call this constructor.
Method | Description |
---|---|
~Destination | Delete the destination. |
getHandle | Get the handle that a C application would use to access the destination. |
getName | Get the name of the destination. |
getTypeId | Get the type of the destination. |
isNull | Determine whether the Destination object is a null object. |
toString | Get the name of the destination in the format of a uniform resource identifier (URI). |
virtual ~Destination();
For a destination that is a queue, this method does not delete the queue in the messaging server unless the queue was created for an XMS temporary queue.
If an application tries to delete a destination that is already deleted, the call is ignored.