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 for DDSDomainParticipantFactory, UNTIL ENABLE for DDSDomainParticipant, DDSPublisher and DDSSubscriber.

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