C++ Syntax

__int32

MKI_ATTRIBUTE_DATA::Add(

__int16 f_nBlockType,

const LPCWSTR f_pszName,

const LPCWSTR f_pszValue,

bool f_fReplace,

__int16 f_nIdent = -1 );

Adds a new attribute to the attribute list.

While this list can technically contain a mix of different attribute types, you should be careful when mixing different attribute types within one list since (in the application) attributes are identified by their name only, and those names are only unique within each type.

Parameters

f_nBlockType

[__int16] Type of attribute (see MKI_DB_ATTRIB_*).

For sorting and access, only the general type ("local", "global", etc.) will be used, not the specific type ("local text", "global number", etc.).

f_pszName

[const LPCWSTR] Name of the attribute to be added.

f_pszValue

[const LPCWSTR] Value of the attribute to be added.

f_fReplace

[bool] If true, an already existing attribute will be replaced with this new one. Otherwise not.

f_nIdent New in Version 2026.0

[__int16] Optional attribute identifier (usually the number of an implicit attribute).

Return Value

Returns the zero-based index of the newly created (or replaced) entry in the list if successful, else -1.