1-114 SOMobjects Base Toolkit: Programmer’s Reference Manual
somGetRelatedClasses Method
Purpose
Returns an array of class objects that were all registered during the dynamic loading of a
class.
IDL Syntax
SOMClass * somGetRelatedClasses (in SOMClass classObj);
Note: For backward compatibility, this method does not take an Environment parameter.
Description
The somGetRelatedClasses method returns an array of class objects that were all
registered during the dynamic loading of the specified class. These classes are considered
to define an affinity group. Any class is a member of at most one affinity group. The affinity
group returned by this call is the one containing the class identified by the classObj
parameter.
The first element in the array is either the class that caused the group to be loaded, or the
special value –1, which means that the class manager is currently in the process of
unregistering and deleting the affinity group (only class-manager objects would ever see this
value). The remainder of the array consists of pointers to class objects, ordered in reverse
chronological sequence to that in which they were originally registered. This list includes the
given argument, classObj, as one of its elements, as well as the class that caused the group
to be loaded (also given by the first element of the array). The array is terminated by a
NULL pointer as the last element.
Use SOMFree to release the array when it is no longer needed. If the supplied class was
not dynamically loaded, it is not a member of any affinity group and NULL is returned.
Parameters
receiver Usually a pointer to SOMClassMgrObject, or a pointer to an instance of a
user-defined subclass of SOMClassMgr.
classObj A pointer to a SOMClass object.
Return Value
The somGetRelatedClasses method returns a pointer to an array of pointers to class
objects, or NULL, if the specified class was not dynamically loaded.
Komentáře k této Příručce