C++ Syntax

MKI_RESULTVALUE

MKI_EnumerateExt(

__int16 f_nOwnerID,

__int16 f_nPlugInID,

MKI_ENTITY_EXT_PTR f_pExt,

__int32 f_nEnumMode,

MKI_ENUMEXT_PROC f_fnCallback,

void* f_pUserData );

Finds the plug-in identified by OwnerID and PlugInID and starts an enumeration of the extended object's native data. This will only work if the plug-in knows the given extended object type.

Parameters

OwnerID New in Version 2022.2

[__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).

PlugInID New in Version 2022.2

[__int16] This value is a plug-in identification. This value can freely be managed by the plug-in's creator. For Malz++Kassner plug-ins, see MKI_PLUGINID_*.

Ext

[MKI_ENTITY_EXT_PTR] Address of the extended object to be enumerated.

EnumMode

[__int32] This value determines the way the extended object shall be enumerated. This mode depends on the plug-in actually enumerating the extended object. Please contact that plug-in's manufacturer for detailed information.

CallBack

[MKI_ENUMEXT_PROC] Callback procedure for an extended object enumeration. This procedure will be called for every enumeration step. For a detailed description of extended object enumeration, see also the description of the MKI_EnumExtProc procedure.

UserData

[void*] This pointer will be passed to all callback procedures that are called during the enumeration. You can use this parameter to pass "local" data to the enumeration, preferably by passing a pointer to a local data structure containing all information the callback procedure requires.

Return Value Changed in Version 2022.1

Enumeration result as a bitwise-or combination of flags (see MKI_RESULT_*). Some results indicate minor problems and do NOT mean that the enumeration was stopped or unsuccessful!

Comment

For a detailed description of extended object enumeration, see the description of the corresponding callback procedure MKI_EnumExtProc.