iterateOverInstances

This function iterates over all available instances loaded in memory, it is the fastest way to find all instances. Argument entity and entityName are both optional and if non-zero are filled with respectively the entity handle and entity name as char array.

Syntax

//
//   Strong typing definition
//
SdaiInstance    iterateOverInstances(
                        SdaiModel               model,
                        SdaiInstance            instance,
                        SdaiEntity              * entity,
                        const char              ** entityName
                    );

static  inline  SdaiInstance    iterateOverInstances(
                                        SdaiModel               model,
                                        SdaiInstance            instance,
                                        SdaiEntity              * entity,
                                        char                    ** entityName
                                    )
{
    return  iterateOverInstances(
                    model,
                    instance,
                    entity,
                    (const char**) entityName
                );
}


//
//   Weak typing definition
//
int_t   __declspec(dllexport) __stdcall iterateOverInstances(
                                                int_t                   model,
                                                int_t                   instance,
                                                int_t                   * entity,
                                                const char              ** entityName
                                            );

static  inline  int_t   iterateOverInstances(
                                int_t                   model,
                                int_t                   instance,
                                int_t                   * entity,
                                char                    ** entityName
                            )
{
    return  iterateOverInstances(
                    model,
                    instance,
                    entity,
                    (const char**) entityName
                );
}
    

Property model

Size: 32 bit / 4 byte (value)
The handle to the model. The model handle is static during its existance. Several models can be opened simultaniously within one session. Different models are always independent, threads are allowed to be running on different models simultaniously.

Property instance

Size: 32 bit / 4 byte (value)
...

Property entity

Size: 32 bit / 4 byte (reference)
...

Property entityName

Size: 32 bit / 4 byte (reference)
...