Description

Find and updates the Journal Node associated with the Object.

Return Type

A McDBNode object.   A McDBNode with value referencing the (SUCCESSFULLY) updated Journal.
Failure Returns Nothing (FAILURE)..

Failure conditions:
* Invalid arguments
* ObjectToJournal failure
* AddObject failure

Syntax

object.ObjectUpdateJournal (pUnknown, eOverWrite, [eDataStorage], [sDisplayName], [vThumbnailSettings])

The ObjectUpdateJournal Method syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McDataJournal.
pUnknownRequired. An IUnknown object. COM Object reference pointing to the object to be overwritten.
eOverWriteRequired. A mcDataNodeOverwrites enumeration, as described in settings. Specifies the granularity of the store operation. The McDataSource implementation decides how the object is added to the Current.Node. The default implementation for the McImage actually adds a new McDBNode to the Children collection of the Current.Node. All implementations must overwrite the Current.Node (itself) when any 'remove' option is specified (mcdaton_Remove*).
eDataStorageOptional. A mcDataNodeStorageMethods enumeration, as described in settings. : The method of storing proprietary data to the the new McDBNode. This value will be mcdatnsm_NotSpecified when a AddFile handler cannot be found.
sDisplayNameOptional. A String value. An identifier specifying a particular McDataSource implementation.
vThumbnailSettingsOptional. A Variant value. : Handler specific data that may be used to configure the Thumbnail creation operation.

Settings

The settings for eOverWrite are:

ConstantValueDescription
 mcdaton_NoOverwriteMakeNew0

Default: FALSE - Add new with all content and make new when instead of overwrite.

 mcdaton_Attributes1

add or overwrite attributes

 mcdaton_AttributesRemoveOld2

remove any existing attributes (prior to save)

 mcdaton_Data4

add or overwrite data

 mcdaton_DataRemoveOld8

remove existing data (prior to save)

 mcdaton_Icons16

add or overwrite icons

 mcdaton_IconsRemoveOld32

remove any existing attributes (prior to save)

 mcdaton_Categories64

add categories

 mcdaton_CategoriesRemoveOld128

remove any existing categories (prior to save)

 mcdaton_Children256

add children

 mcdaton_ChildrenRemoveOld512

remove any existing children (prior to save)

 mcdaton_RemoveOld682

Overwrite All

 mcdaton_All1023

Add or Overwrite all

 mcdaton_AllTrue-1

Legacy support. Same as mcdaton_All.

The settings for eDataStorage are:

ConstantValueDescription
 mcdatnsm_NotSpecified0

No Value. Use default value specified to the database type.

 mcdatnsm_StoreFilepath65536

Store the filename of a file (file must be already saved)

 mcdatnsm_StoreFileData131072

Save the data in the database

 mcdatnsm_StoreCopyFileName262144

Save to a database managed file and store filename in database

 mcdatnsm_All458752

Not a valid value. Use for bit mask of possible values.

Remarks

This function is useful when the COM object does not maintain its Journal McDBNode. This function may be used to refresh the Journal Node interface from the native COM object.