MKI_PLUGIN_CONTAINER (Basic Classes) Changed in Version 2025.1

www.CAD6.com

C++ Syntax

class MKI_PLUGIN_CONTAINER

{

public:

MKI_STR32W m_szRegistry,

MKI_STR32A m_szBuildDate;

LPWSTR m_pszCaption,

m_pszVendor,

m_pszCopyright;

WORD m_wProductMin,

m_wProductMax,

m_wCompileYear,

m_wCompileMonth,

m_wCompileDay;

MKI_STR64A m_szUserName,

m_szUserCode;

__int64 m_nUserTime;

__int32 m_nUserMode,

m_nUserDays;

};

This structure contains a plug-in's complete description as stored by the serving application.

Element Description

The first part of elements has to be initialized by the plug-in before passing the structure to any interface function:

m_szRegistry Changed in Version 2019.1

[MKI_STR32W] File base name of the plug-in in capital letters. This strings is used to locate the plug-in’s data in the registry. Must not be nullptr. Example:

"MKDXF2"

m_szBuildDate

[MKI_STR32A] Physical build date of the plug-in, will be displayed to the user. You can use the macro MKI_GET_BUILD_DATE to create this string automatically, or set the date manually (format is YYYY-MMM-DD). This string does not have to be identical to the date represented by m_wCompileYear, m_wCompileMonth and m_wCompileDay, although it usually will. May not be nullptr. Example:

"2024-Mar-03"

m_pszCaption Changed in Version 2019.1

[LPWSTR] Caption string used in all dialogs that are displayed on behalf of the plug-in. Must not be nullptr. Example:

"Malz++Kassner DXF Import"

m_pszVendor Changed in Version 2019.1

[LPWSTR] A multi-line text that contains the vendor’s address that the customer can use to order an unlock code for the plug-in. Can be set to nullptr if no specific address is to be given. Example:

"Malz++Kassner GmbH\n"

"Am Westerberge 46\n"

"38122 Braunschweig\n"

"Germany\n"

"Phone +49 531 400 137\n"

"Fax +49 531 400 138\n"

"www.CAD6.com"

Please use no more than 7 lines of text, otherwise this text will not fit into the respective dialog windows.

m_pszCopyright Changed in Version 2019.1

[LPWSTR] A multi-line text (maximum 7 lines) that contains copyright information about the plug-in. This text will be used as format string for a sprintf call with m_szBuildDate as a %s parameter. Example:

m_wProductMin

m_wProductMax

[WORD] Range of product serial numbers this plug-in uses. These values are required to check if an unlock code is correct.

m_wCompileYear

m_wCompileMonth

m_wCompileDay New in Version 6.40

[WORD] Logical compile date of the plug-in. These values are required to check if an unlock code is correct (i.e. not expired), and if online updates are available. These values do not have to be identical to the date represented by m_szBuildDate, although they usually will. Example:

m_wCompileYear == 2021, m_wCompileMonth == 4 and m_wCompileDay == 11 means "April 11, 2021"

The second part of elements will be initialized by the serving application once the structure was passed to either MKI_DialogPlugInTest or MKI_DialogPlugInNoTest.

m_szUserName

[MKI_STR64A] Name of the user to which this plug-in is registered.

m_szUserCode

[MKI_STR64A] Unlock code of the plug-in.

m_nUserTime

[__int64] Time when the file was created (0=unknown). This value represents the number of 100-nanosecond intervals since January 1, 1601.

m_nPlugInMode Renamed in Version 2025.1

[__int32] Mode the plug-in is currently running in (see MKI_PLUGINMODE_*).

m_nTrialDays Renamed in Version 2025.1

[__int32] Number of days that are left of the trial period (if any).