|
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
|
|