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