C++ Syntax

bool

MKI_ExtAddBinary(

__int32 f_nType,

const void* const f_pData,

const size_t f_nSize );

Adds a binary data block to a previously opened provisional extended object (see MKI_ExtOpen).

We strongly recommend avoiding the storage of binary data and instead storing multiple data blocks with clearly defined data types such as text, __int32, and double. On the one hand, binary data is difficult to read and write; on the other hand, even small changes to the data structure can cause significant effort when opening older data. Under no circumstances should the contents of classes or structures be stored as a single block of binary data – this would be maintenance hell!

Parameters

f_nType

[__int32] Data block type. Valid range: 1000 ≤ x ≤ 29999. Such a data block will not be modified by the serving application in any case and can be used to store plug-in-specific data.

f_pData

[const void* const] Address of the data to be copied to the data block.

f_nSize

[const size_t] Total size of the data in bytes. Valid range: 0 ≤ x ≤ MKI_DB_SIZE_MAX.

Return Value

Returns true if the data block was added successfully. If false is returned, this indicates that the extended object would be too large after adding this data block.