C++ Syntax

bool

MKI_ProfileDrawingSetData(

__int16 f_nOwnerID,

__int32 f_nProfileID,

MKI_CONST_ENTITY_OBJECT_PTR f_pObjPtr );

Stores a plug-in's object-style profile in a drawing.

Parameters

OwnerID

[__int16] This value is a unique identification of the creator of the plug-in. The value MKI_DB_OWNER_MK is reserved for use by Malz++Kassner. Valid range: 0 <= Value < 10000.

Third-party vendors that plan to implement a plug-in should contact Malz++Kassner to receive their unique identification (see Getting Your Private Owner ID).

ProfileID

[__int32] This value is used to identify the profile for further access. Each plug-in creator can use the full range of the value, as it is used in combination with his OwnerID. Usually, this value will be equal to the plug-in's ID.

As this value is a 32bit value (rather than being a 16bit value like the plug-in's ID), each plug-in can store multiple profiles. In order to do so, store the plug-in's ID in the low-word of ProfileID, and an additional number in its high-word.

ObjPtr

[MKI_CONST_ENTITY_OBJECT_PTR] Address of an object that contains the plug-in's profile data in its data blocks. A copy of this object will be created and stored in the drawing, and the ObjectType element of the object's header will be set to ProfileID, i.e. it does not matter what type of object it was before. You can use MKI_ObjectOpen, MKI_ObjectAddDataBlock, and MKI_ObjectAddEnd to create this object. Once added here, do not forget to call MKI_ObjectClose.

Return Value

Returns true if the profile was stored successfully, else false (indicating out-of-memory).