Represents an event that occurs when the security of an object is changed.

Note that the dynamic inheritance feature of the Content Engine security model impacts

 Copy Code
UpdateSecurityEvent
as follows. First, modifying the security of a folder will not automatically propogate to the documents contained in the folder; that is, the security of the documents in the folder will not change. Therefore, the system will generate an UpdateSecurityEvent object for the folder, but it will not generate an UpdateSecurityEvent object for each contained document. Second, an update to any object-valued property designated as inheritable in the metadata will generate an UpdateSecurityEvent object .

You can instantiate a UpdateSecurityEvent object in the following ways:

  • Call the GetInstance or FetchInstance method on the Factory.UpdateSecurityEvent class.
  • Retrieve the AuditedEvents property on a Document, Folder, or CustomObject object, and iterate the EventSet collection for instances of UpdateSecurityEvent objects.
  • Retrieve a UpdateSecurityEvent object from a UpdateSecurityEventSet collection.

The following tables list the members exposed by IUpdateSecurityEvent.

Public Properties

 NameDescription
Public propertyModifiedPropertiesA list of the symbolic names of the properties modified during a given event. Note that this property is only available when you retrieve the event object, for example, by calling the Factory FetchInstance method. This property is not available from the event object passed to the event action handler.
Public propertyOriginalObjectThe event's source object prior to the event. To get the source object at the time the event occurred, retrieve the SourceObject property. To compare the two states of the source object, fetch the properties of the object returned by the OriginalObject property and the SourceObject property.
Public propertyVersionSeriesIdFor a IPublishCompleteEvent object, the ID of the version series of the publication document. For other versioning-related events, the ID of the version series for the source object. Note that this property will have a valid value only when the event's source object is an instance of IDocument or its subclass.
Top

See Also