RTRegistry Class Reference

<<eXtension>> A run-time component factory. More...

List of all members.

Public Member Functions
bool	register_component (const char *name, RT_ComponentFactoryI *intf, RT_ComponentFactoryProperty *property, RT_ComponentFactoryListener *listener)
	<<cert>> Register a factory of RT components
bool	unregister (const char *name, RT_ComponentFactoryProperty **property, RT_ComponentFactoryListener **listener)
	<<cert>> Remove a component factory from the registry

---

Detailed Description

<<eXtension>> A run-time component factory.

---

Member Function Documentation

bool RTRegistry::register_component	(	const char *	name,
		RT_ComponentFactoryI *	intf,
		RT_ComponentFactoryProperty *	property,
		RT_ComponentFactoryListener *	listener
	)

<<cert>> Register a factory of RT components

In order to make a component available, it is necessary to register a factory for the components. The factory is responsible for creating and deleting components.

The name of the factory must be unique. Otherwise, if a factory already exists with the the same name, the registration will fail.

Parameters:

name	<<in>> Name of the component factory
intf	<<in>> Pointer to the implementation of the factory interface
property	<<in>> Properties with which to create the factory
listener	<<in>> The listener to install with the factory

Returns:

RTI_TRUE on success, RTI_FALSE on failure

MT Safety:

This operation is not thread safe.

API Restriction:

This function must only be called after DDSDomainParticipantFactory::get_instance.

See also:

RTRegistry::unregister

bool RTRegistry::unregister	(	const char *	name,
		RT_ComponentFactoryProperty **	property,
		RT_ComponentFactoryListener **	listener
	)

<<cert>> Remove a component factory from the registry

After a component factory is unregistered, it will no longer be possible to create or delete components with the factory.

Parameters:

name	<<in>> Name of the component factory
property	<<in>> Properties with which the factory was created
listener	<<in>> The listener installed with the factory

Returns:

RTI_TRUE on success, RTI_FALSE on failure

MT Safety:

This operation is not thread safe.

See also:

RTRegistry::register_component