Update Method (Folder Object)

The Update method saves changes to the Folder object in the MAPI system.

Syntax

objFolder.Update( [makePermanent] [, refreshObject] )

objFolder
Required. The Folder object.
makePermanent
Optional. Boolean. A value of True indicates that the property cache is flushed and all changes are committed in the underlying message store. False indicates that the property cache is flushed but not committed to persistent storage. The default value is True.
refreshObject
Optional. Boolean. A value of True indicates that the property cache is reloaded from the values in the underlying message store. False indicates that the property cache is not reloaded. The default value is False.

Remarks

Changes to Folder objects are not permanently saved in the MAPI system until you call the Update method with the makePermanent parameter set to True.

For improved performance, CDO caches property changes in private storage and updates either the object or the underlying persistent storage only when you explicitly request such an update. For efficiency, you should make only one call to Update with its makePermanent parameter set to True.

The makePermanent and refreshObject parameters combine to cause the following changes:

refreshObject = True refreshObject = False
makePermanent = True Commit all changes, flush the cache, and reload the cache from the message store. Commit all changes and flush the cache (default combination).
makePermanent = False Flush the cache and reload the cache from the message store. Flush the cache.

Call Update(False, True) to flush the cache and then reload the values from the message store.