edmiRemoteUnsetAggrElement

 
Unsets an array element identified by its element index. This function is only applicable on aggregates of array type.
Related functions: edmiRemoteUnsetAggrElements, edmiRemoteTestAggrElement.
Header:
#include "sdai.h"
Prototype:
EdmiError edmiRemoteUnsetAggrElement(SdaiServerContext serverContextId,
                                      SdaiAggr          aggrId, 
                                      SdaiAggrIndex     index, 
                                      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:
/*
SCHEMA DentalStatus; 
ENTITY Tooth; 
Fillings : INTEGER; 
END_ENTITY; 
ENTITY Incisor SUBTYPE OF (Tooth); END_ENTITY; 
ENTITY Canin SUBTYPE OF (Tooth); END_ENTITY; 
ENTITY Molar SUBTYPE OF (Tooth); END_ENTITY; 
ENTITY Wisdom SUBTYPE OF (Molar); END_ENTITY; 
ENTITY Patient; 
CustomerId : INTEGER; 
ToothSet : ARRAY [1:32] OF OPTIONAL Tooth; 
END_ENTITY; 
END_SCHEMA; 
*/
EdmiError rstat;
SdaiServerContext myContext;
SdaiModel modelId;
SdaiInteger nHits, index;
SdaiInstance patientId;
SdaiAggr toothSet;
 
/* Define Remote Server Context */
rstat = edmiDefineServerContext("MyRemoteServerContext",
"Johnny", "Dentist", "cf37ftr", 
"TCP", "9090", "MyServerHost", 
NULL, NULL, NULL, NULL, NULL, &myContext); 
 
/* Get the modelId of the
patient register model */ 
rstat = edmiRemoteGetModelBN(myContext, "DataRepository",
"PatientRegister", &modelId, NULL); 
 
/* Get the instance Id of the patient
with customerId 8745 */ 
nHits = 1;
index = 0;
rstat = edmiRemoteFindInstancesBN(myContext, modelId,
"Patient", "CustomerId = 8745", 
sizeof(SdaiInstance), &index, &nHits, 
&patientId, NULL); 
 
/* Get the patients toothset */
rstat = edmiRemoteGetAttrsBN(myContext, patientId, 0, 1, NULL,
"ToothSet", sdaiAGGR, &toothSet); 
 
/* The patients upper left wisdom molar
(toothSet element 1) has been drawn out */ 
rstat = edmiRemoteUnsetAggrElement(myContext,
toothSet, 1, NULL); 
. . .