Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »


 
Returns the numeric instanceID that uniquely identifies the entity extent instance for the specified instance type in the specified model. There is one entity extent instance in a model for each possible instance type in that model.
The actual model must be open before this function can be successfully performed.
Note: The sdaiGetEntityExtent and sdaiGetEntityExtentBN functions return the aggregateID of the attribute named instances in the related entity extent instance. The edmiGetExtent and edmiGetExtentBN functions return the instanceID of the related entity extent instance.
Related functions: edmiGetExtentBN , sdaiGetEntityExtent , sdaiGetEntityExtentBN .
Header:
#include "sdai.h"
Prototype:
 SdaiInstance edmiGetExtent(SdaiModel  model,
                            SdaiEntity entityId); 
Arguments:

model

A numeric modelID that uniquely identifies the model of interest in the EDMdatabase .
The modelID is returned from the functions: sdaiCreateModel , sdaiCreateModelBN , sdaiOpenModelBN , edmiGetModel , edmiGetModelBN , sdaiGetInstanceModel

entityId

A numeric entityID that uniquely identifies the entity definition instance of interest in the EDMdatabase , i.e. defines the entity extent instance of interest.
The entityID is returned by the sdaiGetEntity function.

Returns:
A numeric instanceID that uniquely identifies the entity extent instance for the specified instance type in a specified model in the EDMdatabase will be returned. The instanceID can have the following values:
instanceID = 0 : Error in operation. Use sdaiErrorQuery to get error code and edmiGetErrorText to get the error message.
instanceID != 0: Function successfully performed.
EXAMPLE
SdaiInstance extentId;
SdaiModel modelId;
SdaiEntity entityId;
. . .
extentId = edmiGetExtent (modelId, entityId, &extentId);
if (! extentId) {
/* Error in operation */ 
printf("\nError: %s in edmiGetExtent\n", 
edmiGetErrorText(sdaiErrorQuery())); 
goto error; 
}
printf("\nextentId: %lu", extentId);
. . .

  • No labels