DDS_EntityFactoryQosPolicy Struct Reference

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

#include <dds_c_infrastructure.h>

Data Fields
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 DDS_Entity types that can act as factories for one or more other DDS_Entity types.

Entity:

DDS_DomainParticipantFactory, DDS_DomainParticipant, DDS_Publisher, DDS_Subscriber

Properties:

RxO = NO
Changeable = YES

Usage

This policy controls the behavior of the DDS_Entity 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 DDS_Entity_enable operation each time a new DDS_Entity is created. Therefore, the DDS_Entity returned by create_<entity> will already be enabled. A setting of DDS_BOOLEAN_FALSE indicates that the DDS_Entity will not be automatically enabled. The application can enable entities explicitly using the DDS_Entity_enable operation.

By default, autoenable_created_entities is set to DDS_BOOLEAN_TRUE, so newly created entities are automatically enabled without needing to call DDS_Entity_enable.

Field Documentation

autoenable_created_entities

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 automatically enable created entities.

[default] DDS_BOOLEAN_TRUE