MKI_AttributeGetLocal (Attributes) Changed in Version 2021.1

C++ Syntax

__int32

MKI_AttributeGetLocal(

 MKI_CONST_ENTITY_PTR f_pEntity,

 MKI_ATTRIBUTE_DATA_PTR f_pData,

 bool f_fGlobal );

Retrieves all local attributes from a given entity plus, in case of an instance and only if requested, any global attributes from a referenced block.

Parameters

Entity

[MKI_CONST_ENTITY_PTR] Address of the entity whose attributes shall be retrieved.

Data

[MKI_ATTRIBUTE_DATA_PTR] Address of a buffer that shall received all retrieved attributes. You can use MKI_AttributeBuffer to allocate a buffer of the required size.

Global Changed in Version 2021.1

[bool] If true, all global attributes from a referenced block will also be retrieved.

Return Value

Returns the number of attributes retrieved. If a negative value is returned, this indicates invalid parameters.