C++ Syntax

MKI_BlockInsert(

const LPCWSTR f_pLibraryName,

bool f_fBoosted );

Appends the provisional block (see MKI_BlockOpen) to the block memory list of the drawing or to a library.

In most cases, you can use MKI_BlockInternalFastInsert instead of this procedure to speed up execution and to reduce code size. See the description of that procedure for details.

Parameters

LibraryName

[const LPCWSTR] Name of the library the block shall be inserted to. If the library name is MKI_BLOCK_ID, the block will be added to the drawing's block memory list.

Boosted

[bool] If true, the block will be inserted only preliminary, i.e. without updating the internal block list and its flags. To finalize the insertion(s), you must call MKI_BlockUpdateList once you're finished creating blocks. This will significantly speed up the creation of a huge number of blocks at once.

Return Value

Returns the address of the inserted block. Returns nullptr if the insertion was not successful, normally due to insufficient memory, or if another block with the same name already exists.