Interface DependentObject
-
- All Known Subinterfaces:
- AccessPermission, AccessPermissionDescription, ActiveMarking, AddOnInstallationRecord, ApplicationSecurityTemplate, AsyncProcessingConfiguration, AuditDefinition, CenteraSiteSettings, CFSImportAgentConfiguration, CFSSiteSettings, Choice, CmAuditingConfiguration, CmChangePreprocessorDefinition, CmDirectoryConfigurationConnections, CmDirectoryConfigurationDomino, CmDirectoryConfigurationOID, CmDirectoryConfigurationRadiantOne, CmDirectoryConfigurationVMM, CmIndexJobResyncItem, CmIndexPartitionConstraint, CmIndexPartitionConstraintDate, CmIndexPartitionConstraintString, CmProcessEngineConfiguration, CmSweepConfiguration, CmTextSearchConfiguration, CmTextSearchIndex, CmTextSearchPartitionDateProperty, CmTextSearchPartitionProperty, CmTextSearchPartitionStringProperty, CmThreadPoolConfiguration, CmTimeslot, ColumnDefinition, ContentCacheConfiguration, ContentConfiguration, ContentElement, ContentReference, ContentTransfer, DirectoryConfiguration, DirectoryConfigurationAD, DirectoryConfigurationAdam, DirectoryConfigurationCA, DirectoryConfigurationIBM, DirectoryConfigurationNovell, DirectoryConfigurationSunOne, DiscretionaryPermission, DocumentState, ExternalAlias, ExternalClassAlias, ExternalIdentity, ExternalParticipant, ExternalPropertyAlias, ExternalPropertyDescription, ImageServicesClassDescription, ImageServicesImportAgentConfiguration, ImageServicesPropertyDescription, ImageServicesSiteSettings, IndexJobClassItem, IndexJobCollectionItem, IndexJobItem, IndexJobSingleItem, LocalizedString, Marking, ObjectStoreParticipant, Permission, PermissionDescription, PropertyDefinition, PropertyDefinitionBinary, PropertyDefinitionBoolean, PropertyDefinitionDateTime, PropertyDefinitionFloat64, PropertyDefinitionId, PropertyDefinitionInteger32, PropertyDefinitionObject, PropertyDefinitionString, PropertyDescription, PropertyDescriptionBinary, PropertyDescriptionBoolean, PropertyDescriptionDateTime, PropertyDescriptionFloat64, PropertyDescriptionId, PropertyDescriptionInteger32, PropertyDescriptionObject, PropertyDescriptionString, PublishingConfiguration, ReplicationConfiguration, ReplicationParticipant, SecurityTemplate, ServerCacheConfiguration, SiteSettings, SubscribedEvent, SubsystemConfiguration, TraceLoggingConfiguration, VerityCollection, VerityServerConfiguration, VersioningSecurityTemplate
public interface DependentObject
Indicates objects that are dependent. ADependentObject
represents anEngineObject
that can only exist within the scope of another object. An example of this dependency isContentElement
; content elements are scoped to a particularDocument
object and cannot exist independently. Contrast this with anIndependentObject
, which is anEngineObject
that has its own independent identity.The identity and security of a dependent object are derived from that of its parent independent object.
DependentObject
s andDependentObjectList
s are not reusable. That is, aDependentObject
orDependentObjectList
taken from a fetched object should not be reassigned to another object. Once they have been assigned to one parent object, they must not be assigned to a second parent object. For example, you should not fetch thePermission
obects for one object and then try to directly use those samePermission
objects on another object. If you attempt such reuse, the results are unpredictable. In some cases, there may be no adverse effects. The operation might appear to succeed but give results other than what the caller expects, for example, errors when you try to save the object. In other cases, the attempted operation might fail with symptoms that are difficult to diagnose.Any attempt to assign an already-assigned
DependentObject
to another parent object causes a warning message to be written to the client trace log.Note: While this type of operation might succeed with the 4.0 Content Engine API, the behavior is unreliable and future releases of the Content Engine API will prohibit reuse by throwing a runtime exception.