Removes all instances from an instance container identified by its name and the modelId. The removed instances will not be removed from the model. This function may not be used unless the container was assigned a name when it was created. I no name was assigned, use edmiEmptyContainer.
Related functions: edmiCreateInstanceContainer, edmiDeleteInstanceContainer, edmiDeleteInstanceContainerBN, edmiEmptyContainer, edmiGetInstanceContainerId, edmiGetInstanceContainers, edmiSetContainerCheckedout, edmiSetContainerCheckedoutBN, edmiUnsetContainerCheckedout, edmiUnsetContainerCheckedoutBN, edmiInstanceToContainer, edmiInstanceToContainerBN, edmiInstancesToContainer, edmiInstancesToContainerBN.
Header:
#include "sdai.h"
Prototype:
EdmiError edmiEmptyContainerBN(SdaiModel modelId,
SdaiString containerName);
Arguments:
modelId |
Instance Id that uniquely identifies the edmModel in the EDMdatabase |
containerName |
The optional name that was assigned to the instance container when it was created. |
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;
. . .
if (rstat = edmiEmptyContainerBN(modelId, "myContainer")) {
printf("\nError %d in edmiEmptyContainerBN: %s", rstat,
edmiGetErrorText(rstat));
goto err;
}
. . .