ObjectUpdateJournal Method

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:

Part	Description
object	An expression evaluating to an object of type McDataJournal.
pUnknown	Required. An IUnknown object. COM Object reference pointing to the object to be overwritten.
eOverWrite	Required. 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*).
eDataStorage	Optional. 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.
sDisplayName	Optional. A String value. An identifier specifying a particular McDataSource implementation.
vThumbnailSettings	Optional. A Variant value. : Handler specific data that may be used to configure the Thumbnail creation operation.

Settings

The settings for eOverWrite are:

Constant		Value	Description
	mcdaton_NoOverwriteMakeNew	0	Default: FALSE - Add new with all content and make new when instead of overwrite.
	mcdaton_Attributes	1	add or overwrite attributes
	mcdaton_AttributesRemoveOld	2	remove any existing attributes (prior to save)
	mcdaton_Data	4	add or overwrite data
	mcdaton_DataRemoveOld	8	remove existing data (prior to save)
	mcdaton_Icons	16	add or overwrite icons
	mcdaton_IconsRemoveOld	32	remove any existing attributes (prior to save)
	mcdaton_Categories	64	add categories
	mcdaton_CategoriesRemoveOld	128	remove any existing categories (prior to save)
	mcdaton_Children	256	add children
	mcdaton_ChildrenRemoveOld	512	remove any existing children (prior to save)
	mcdaton_RemoveOld	682	Overwrite All
	mcdaton_All	1023	Add or Overwrite all
	mcdaton_AllTrue	-1	Legacy support. Same as mcdaton_All.

The settings for eDataStorage are:

Constant		Value	Description
	mcdatnsm_NotSpecified	0	No Value. Use default value specified to the database type.
	mcdatnsm_StoreFilepath	65536	Store the filename of a file (file must be already saved)
	mcdatnsm_StoreFileData	131072	Save the data in the database
	mcdatnsm_StoreCopyFileName	262144	Save to a database managed file and store filename in database
	mcdatnsm_All	458752	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.