C++ Syntax

bool

MKI_ProfileSetFolders(

const LPCWSTR f_pszFolder1 = nullptr, __int32 f_nArrayIndex1 = -1,

const LPCWSTR f_pszFolder2 = nullptr, __int32 f_nArrayIndex2 = -1 );

Adds one or two "folders" to the name of the opened key in the configuration file or a collection item. Works both for reading and writing.

All folders are connected by points and may include array indexes in brackets, e.g. Folder1[ArrayIndex1].Folder2[ArrayIndex1]. The total length of the opened key's name plus these three folder names must not exceed 255 characters.

Parameters

f_pszFolder1

f_pszFolder2

[const LPCWSTR] Names of the folders or nullptr.

f_nArrayIndex1

f_nArrayIndex2

[__int32] Array indexes to be added to the folders' names in brackets. Will be ignored if negative.

Return Value

Returns true if successful, false if not.

Examples

A call of:

MKI_ProfileSetFolders( L"Database", -1, L"Entry", 4 );

will result in the following folder structure:

Database.Entry[4]

A call of:

MKI_ProfileSetFolders( L"Database", 3, L"Options" );

will result in the following folder structure:

Database[3].Options