edmiInstanceToContainer


 

EdmiError edmiInstanceToContainer(SdaiContainer   sourceContainerId,
                                    SdaiContainer   targetContainerId,
                                    SdaiAppInstance currInst);

Adds/removes a single instance to/from an instance container identified by its containerId. This function may also move an instance between containers. The behaviour is controlled by the values given in the source and target parameters <sourceContainerId> and < targetContainerId >. The table below illustrates this;

 

source

target

Behavior

Unset

Set

The instances will be inserted into the target container.

Set

Unset

The instances will be removed from the source container.

Set

Set

The instances will be moved from source to target. I.e removed from the source container and inserted into the target container.

Arguments


TypeNameComment
SdaiContainer

sourceContainerId

The containerId of the instance container from which to remove the instance <currInst>. By default, the instance will not be removed from any container.

SdaiContainer

targetContainerId

The containerId of the instance container in which to insert the instance <currInst>. By default, the instance will not be inserted into any container.

SdaiAppInstance

currInst

Specifies a numeric instanceID that uniquely identifies an application instance in the EDMdatabase.

Return Value


Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'US:_r_EDMInterface'.

Options


 

Example


 

 EdmiError rstat;
 int i;
 SdaiModel modelId = 0;
 SdaiInstance instId;
 SdaiContainer contId = 0;
 . . .
 rstat = edmiCreateInstanceContainer(modelId, MODEL_CONTAINER,
 "Contacts", "Johnnys contacts", 
 &contId); 
 rstat = edmiProtectInstance(contId, (PUBLIC_NONE |
 GROUP_NONE | OWNER_WRITE)); 
 instId = edmiCreateInstanceAndPutAttrsBN(modelId, "FRIEND", 3,
 "FIRSTNAME", sdaiSTRING, "Lucy", 
 "LASTNAME", sdaiSTRING, "Grant", 
 "BIRTHDATE", sdaiSTRING, "01.13.1987"); 
 /* Add lucy to contacts container */
 if (rstat = edmiInstanceToContainer(0, contId, instId)) {
 printf("\nError %d in edmiInstanceToContainer: %s", rstat, 
 edmiGetErrorText(rstat)); 
 goto err; 
 }
 . . .

 

See also

Filter by label

There are no items with the selected labels at this time.

 

Â