Errata exists for this version of the document.
MoveOrCopy is used to move or copy a file or directory organized by this Object to another directory or to rename a file or directory.
Signature
MoveOrCopy(
[in] NodeId objectToMoveOrCopy
[in] NodeId targetDirectory
[in] Boolean createCopy
[in] String newName
[out] NodeId newNodeId
);
Argument |
Description |
objectToMoveOrCopy |
The NodeId of the file or directory to move or copy. |
targetDirectory |
The NodeId of the target directory of the move or copy command. If the file or directory is just renamed, the targetDirectory matches the ObjectId passed to the method call. |
createCopy |
A flag indicating if a copy of the file or directory should be created at the target directory. |
newName |
The new name of the file or directory in the new location. If the string is empty, the name is unchanged. |
newNodeId |
The NodeId of the moved or copied object. Even if the Object is moved, the Server may return a new NodeId. |
Method Result Codes (defined in Call Service)
Result Code |
Description |
Bad_BrowseNameDuplicated |
See OPC 10000-4 for a general description. A file or directory with the name already exists. |
Bad_NotFound |
See OPC 10000-4 for a general description. A file or directory with the provided NodeId is not organized by this object. |
Bad_InvalidState |
See OPC 10000-4 for a general description. The file or directory is locked and thus cannot be moved or copied. |
Bad_UserAccessDenied |
See OPC 10000-4 for a general description. |
Table C.12 specifies the AddressSpace representation for the MoveOrCopy Method.
Table C.12 – MoveOrCopy Method AddressSpace Definition
Attribute |
Value |
||||
BrowseName |
MoveOrCopy |
||||
References |
NodeClass |
BrowseName |
DataType |
TypeDefinition |
ModellingRule |
HasProperty |
Variable |
InputArguments |
Argument[] |
PropertyType |
Mandatory |
HasProperty |
Variable |
OutputArguments |
Argument[] |
PropertyType |
Mandatory |