C++ Syntax

bool

MKI_PhysicalDeleteBlock(

const LPCWSTR f_pszBlockName,

const LPCWSTR f_pszLibraryName,

bool f_fOnlyIfUnused );

Physically and permanently deletes the given block, i.e. it cannot be undeleted by the user.

This command should be used carefully, since it deletes a block permanently. If OnlyIfUnused is set to true, the block will only be deleted if it is currently unused - which does not mean that is might not be used again after the user reverses the last commands!

Parameters

BlockName

[const LPCWSTR] Name of the block to be deleted.

LibraryName

[const LPCWSTR] Name of the library the block is located in.

OnlyIfUnused

[bool] If this value is true, and LibraryName is equal to MKI_BLOCK_ID, the given block will only be deleted if it is not currently used. Else, the block will be deleted in any case.

Return Value

Returns true if the stated block has either been deleted successfully or did not exist. Else, false is returned.