MKI_PLUGIN_CONTAINER (Basic Classes) Changed in Version 2019.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:

Registry 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"

BuildDate

[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 CompileYear, CompileMonth and CompileDay, although it usually will. May not be nullptr. Example:

"2024-Mar-03"

Caption 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"

Vendor 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.

[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 BuildDate as a %s parameter. Example:

ProductMin

ProductMax

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

CompileYear

CompileMonth

CompileDay 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 BuildDate, although they usually will. Example:

CompileYear == 2021, CompileMonth == 4 and CompileDay == 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.

UserName

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

UserCode

[MKI_STR64A] Unlock code of the plug-in.

UserTime

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

UserMode

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

UserDays

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