Move Method  
 

Move a stored object to another container.

Syntax

object.Move( OldLabel, NewLabel [, StorageType] )

Parameters

OldLabel
A string which specifies the label of the object that should be moved.
NewLabel
A string which specifies the new label for the object being moved.
StorageType
A numeric value that identifies the storage container type. One of the following values should be specified. If this parameter is omitted, the object will be moved within the current container.
Value Constant Description
1 webStorageGlobal Global storage. Objects stored using this storage type are available to all users. Any changes made to objects using this storage type will affect all users of the application. Unless there is a specific need to limit access to the objects stored by the application to specific domains, local machines or users, it is recommended that you use this storage type when creating new objects.
2 webStorageDomain Local domain storage. Objects stored using this storage type are only available to users in the same local domain, as defined by the domain name or workgroup name assigned to the local system. If the domain or workgroup name changes, objects previously stored using this storage type will not be available to the application.
3 webStorageMachine Local machine storage. Objects stored using this storage type are only available to users on the same local machine. The local machine is identified by unique characteristics of the system, including the boot volume GUID. Objects previously stored using this storage type will not be available on that system if the boot disk is reformatted.
4 webStorageUser Current user storage. Objects stored using this storage type are only available to the current user logged in on the local machine. The user identifier is based on the Windows user SID that is assigned when the user account is created. If the user account is deleted, the objects previously stored using this storage type will not be available to the application.

Return Value

A value of True is returned if the object was moved. Otherwise, a value of False is returned and the LastError property will return the specific cause of the failure.

Remarks

The Move method is used to move an existing storage object to a new container. For example, it can move an object originally created in the webStorageUser container to the webStorageMachine container. Using this method to move an object within the same container is effectively the same as calling the Rename method.

This method updates the current object. Various properties such as ObjectId and ObjectLabel will reflect the values associated with the object which has been moved.

See Also

Copy Method, Delete Method, Rename Method