...
This operation copies an instance graph within one data model> or from one data model to another. The source instance graph consists of all instances that are directly or indirectly used by the source instance. The target instance(s) will implicitly be created, hence copy between existing instances cannot be performed by this operation. Optionally this operation can copy a partial instance graph, one complete or one partial instance. The data model locating the source instance must be open for read access and the target data model must be open for write access, before this operation can be successfully performed.
Arguments
...
| Type | Name | Comment |
| SdaiInstance | sourceInstanceId | A numeric instanceID that uniquely identifies the instance to be copied in the EDMdatabase. |
| SdaiModel | modelId | A numeric modelID that uniquely identifies the data model locating the target instance(s). This target model must be a population of the same schema as the model that locates the <sourceInstanceId>. |
| SdaiInteger | options | Specifies the options to be used in the invocation of the edmiConditionalDeepCopyInstance function. The <options> value can be specified as a bitwise OR between the actual options to enable. All option names are defined on the header file sdai.h. See detailed descriptions of the available options below. |
| SdaiEntity | exclude_or_include | Address of an array of instances or instance types (entities). The content is dependent of the value of the <options> argument. An instanceID = 0 terminates the <exclude_or_include> array. When appropriate, NULL can be the value of this argument. |
| SdaiInstance | newInstanceId | An address to a variable that will receive a numeric instanceID that will uniquely identify the created instance (target instance) in the EDMdatabase. |
...