RTI Connext DDS Micro C++ API  Version 3.0.1
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups
DDS_EntityFactoryQosPolicy Struct Reference

<<cert>> A QoS policy for all DDSEntity types that can act as factories for one or more other DDSEntity types. More...

#include <dds_c_infrastructure.h>

List of all members.

Public Attributes

DDS_Boolean autoenable_created_entities
 Specifies whether the entity acting as a factory automatically enables the instances it creates.

Detailed Description

<<cert>> A QoS policy for all DDSEntity types that can act as factories for one or more other DDSEntity types.

Entity:
DDSDomainParticipantFactory, DDSDomainParticipant, DDSPublisher, DDSSubscriber
Properties:
RxO = NO
Changeable = YES

Usage

This policy controls the behavior of the DDSEntity as a factory for other entities.

This policy is mutable. A change in the policy affects only the entities created after the change; not the previously created entities.

The setting of autoenable_created_entities to DDS_BOOLEAN_TRUE indicates that the factory create_<entity> operation will automatically invoke the DDSEntity::enable operation each time a new DDSEntity is created. Therefore, the DDSEntity returned by create_<entity> will already be enabled. A setting of DDS_BOOLEAN_FALSE indicates that the DDSEntity will not be automatically enabled. The application will need to enable it explicitly by means of DDSEntity::enable operation.

The default setting of autoenable_created_entities = DDS_BOOLEAN_TRUE means that, by default, it is not necessary to explicitly call DDSEntity::enable on newly created entities.


Member Data Documentation

DDS_Boolean DDS_EntityFactoryQosPolicy::autoenable_created_entities

Specifies whether the entity acting as a factory automatically enables the instances it creates.

If DDS_BOOLEAN_TRUE, the factory will automatically enable each created entity. Otherwise, it will not.

[default] DDS_BOOLEAN_TRUE


RTI Connext DDS Micro C++ API Version 3.0.1 Copyright © Thu Oct 24 2019 Real-Time Innovations, Inc