edmiWideCopyInstanceBN

To be completed
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.
Related functions: edmiConditionalDeepCopyInstance , edmiConditionalDeepCopyInstances , edmiDeepDeleteInstance
Header:
#include "sdai.h"
Prototype:
EdmiError edmiWideCopyInstanceBN(SdaiInstance instanceId,
                                  SdaiModel    modelId,
                                  SdaiInteger  options,
                                  SdaiString   *INinclusiveExclusiveRecursive,
                                  SdaiString   *INinclusiveExclusiveShallow,
                                  SdaiString   *OUTinclusiveExclusiveRecursive,
                                  SdaiString   *OUTinclusiveExclusiveShallow,
                                  SdaiInstance *newInstanceId);

Arguments:

instanceId	A numeric instanceID that uniquely identifies the instance to be copied in the EDMdatabase.
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 <instanceId>.
options	Specifies the options to be used in the invocation of the edmiWideCopyInstanceBN 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.
INinclusiveExclusiveRecursive
INinclusiveExclusiveShallow
OUTinclusiveExclusiveRecursive
OUTinclusiveExclusiveShallow
newInstanceId	An address to a variable that will receive a numeric instanceID that will uniquely identify the created instance (target instance) in the EDMdatabase.

Options: Descriptions:

INCLUDE_FILTER
EXCLUDE_FILTER

Returns:
A completion code of datatype EdmiError is the returned function value. The completion code has the following values:
Completion code = 0: Operation successfully performed.
Completion code != 0: Error in operation. Completion code is an EDMinterface error code. Use edmiGetErrorText to get the error text corresponding to the error code.
EXAMPLE
EdmiError rstat;
SdaiInstance instanceId, newInstanceId;
SdaiModel modelId;
. . .