DictionaryHandle :: CreateTempExtent - Create temporary extent
A temporary extent can be created for storing results of a query (e.g. a selection) within an application. Temporary extents are created in main storage or in a temporary database and are available as long as the database handle is opened. They will be removed automatically when closing the database handle.
When a temporary extent has been created once, one may open any number of property handles for accessing the extent.
One may define an extent for a structure definition defined in the external dictionary by referring to the structure name) or by an internal structure definition that has been created by the application and is referenced by the field definition passed to the function.
Implementation details
- strnames - Type name
- extnames_nc - - Title unknown
- key_name_w
- Key name for conversion
Default: NString::Null()
- baseexts_w
- Name for base extent
Default: NString::Null()
- weak_opt_w
- Weak-typed option
This option must be true (YES) when a collection may refer to instances of different types, which are based on the same base structure.
Default: NO
- own_opt_w
- Owning collection
This option must be set to true (YES) if the collection owns the instances it is referring to. In this case the collection may not refer to instances from other collections. Removing instances from an owning collection will result in deleting the instance completely.
Default: NO