edmiRemoteEmptyContainer

 
Removes all instances from an instance container identified by its containerId. The removed instances will not be removed from the edmModel.
Related functions: edmiRemoteCreateInstanceContainer, edmiRemoteDeleteInstanceContainer, edmiRemoteDeleteInstanceContainerBN, edmiRemoteEmptyContainerBN, edmiRemoteGetInstanceContainerId, edmiRemoteGetInstanceContainers, edmiRemoteSetContainerCheckedout, edmiRemoteSetContainerCheckedoutBN, edmiRemoteUnsetContainerCheckedout, edmiRemoteUnsetContainerCheckedoutBN, edmiRemoteInstancesToContainer, edmiRemoteInstancesToContainerBN, edmiRemoteInstanceToContainer, edmiRemoteInstanceToContainerBN.
Header:
#include "sdai.h"
Prototype:
EdmiError edmiRemoteEmptyContainer(SdaiServerContext serverContextId,
                                    SdaiContainer     containerId, 
                                    SdaiInvocationId  *edmiInvocationId);
 
Arguments:

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;
SdaiModel modelId;
SdaiContainer contId;
SdaiServerContext myContext;
SdaiQueryResult queryResult;
SdaiInteger index = 0, nHits = 10000;
 
/* Define Remote Server Context */
rstat = edmiDefineServerContext("MyRemoteServerContext",
"Johnny", "Supervisor", "cf37ftr", 
"TCP", "9090", "MyServerHost", 
NULL, NULL, NULL, NULL, NULL, &myContext); 
 
/* Create a lock container */
rstat = edmiRemoteCreateInstanceContainer(myContext,
modelId, LOCK_CONTAINER, "FLOOR01", 
"Check out of first floor", &contId, NULL); 
 
/* Select instances to lock */
rstat = edmiRemoteSelectInstances(myContext,
"DataRepository", "GeneralHospital", 
"CONSTRUCTION_ELEMENT", "FLOOR = 1",  
SUBTYPES | ONLY_INSTANCE_IDS,  
NULL, NULL, NULL, &index, &nHits, &queryResult,  
NULL, NULL, NULL, NULL); 
 
/* Put first floor in the container */
rstat = edmiRemoteInstancesToContainer(myContext, 0, contId,
0, queryResult->instanceIds, NULL); 
edmiFreeQueryResult(queryResult);
 
/* Check out the container */
rstat = edmiRemoteProtectInstance(myContext, contId,
(PUBLIC_READ | GROUP_READ | OWNER_WRITE), NULL); 
rstat = edmiRemoteSetContainerCheckedout(myContext, contId, NULL);
 
. . .
/* Manipulate data here */
. . .
 
/* Check in the container */
rstat = edmiRemoteUnsetContainerCheckedout(myContext, contId, NULL);
rstat = edmiRemoteProtectInstance(myContext, contId,
(PUBLIC_READ | GROUP_WRITE | OWNER_WRITE), NULL); 
 
/* Empty and delete the container */
rstat = edmiRemoteEmptyContainer(myContext, contId, NULL);
rstat = edmiRemoteDeleteInstanceContainer(myContext, contId, NULL);
. . .