C++ Syntax

bool

MKI_LibraryAdd(

const LPCWSTR f_pszFileName,

bool f_fReadOnly,

__int32 f_nEmbedding,

bool f_fNoDialog );

Adds an existing library file to the list of loaded libraries.

Parameters

FileName

[const LPCWSTR] The existing library's file name.

ReadOnly

[bool] If true, the library will be marked as read-only.

Embedding

[__int32] Embedding mode for this library. Possible values are:

MKI_LIBRARYEMBEDDING_NEVER

Blocks from this library cannot be embedded.

MKI_LIBRARYEMBEDDING_USER

The user can decide every time a block from this library is instanced whether it will be embedded or not.

MKI_LIBRARYEMBEDDING_ALWAYS

Blocks from this library will always be embedded.

NoDialog

[bool] If true, no progress dialog will be displayed.

Return Value

Returns true if successful. If false is returned, the list was full, the library collided with a library already in the list (same file name or same title), or the given library file was invalid in any way.