DDS::TopicDataQosPolicy Class Reference
[TOPIC_DATA]

Attaches a buffer of opaque data that is distributed by means of Built-in Topics during discovery. More...

#include <managed_infrastructure.h>

List of all members.

Static Public Member Functions

static System::String^ get_topicdata_qos_policy_name ()
 Stringified human-readable name for DDS::TopicDataQosPolicy.

Public Attributes

ByteSeqvalue
 a sequence of octets


Detailed Description

Attaches a buffer of opaque data that is distributed by means of Built-in Topics during discovery.

Entity:
DDS::Topic
Properties:
RxO = NO
Changeable = YES
See also:
DDS::DomainParticipant::get_builtin_subscriber

Usage

The purpose of this QoS is to allow the application to attach additional information to the created DDS::Topic objects, so that when a remote application discovers their existence, it can access that information and use it for its own purposes. This extra data is not used by RTI Data Distribution Service.

One possible use of this QoS is to attach security credentials or some other information that can be used by the remote application to authenticate the source.

In combination with DDS::DataReaderListener, DDS::DataWriterListener, or operations such as DDS::DomainParticipant::ignore_topic, this QoS policy can assist an application in defining and enforcing its own security policies.

The use of this QoS is not limited to security; it offers a simple, yet flexible extensibility mechanism.

Important: RTI Data Distribution Service stores the data placed in this policy in pre-allocated pools. It is therefore necessary to configure RTI Data Distribution Service with the maximum size of the data that will be stored in policies of this type. This size is configured with DDS::DomainParticipantResourceLimitsQosPolicy::topic_data_max_length.


Member Data Documentation

a sequence of octets

[default] empty (zero-length)

[range] Octet sequence of length [0,max_length]


RTI Data Distribution Service .Net APIs Version 4.5e Copyright © 23 Oct 2011 Real-Time Innovations, Inc