| EM_abandon | Function (ROM Call 0x15B)

flash.h

void EM_abandon (HANDLE h);

Abandon an archive memory block.

EM_abandon abandons an archive memory block associated with handle h. More precise, it frees the handle by clearing the entry in the heap table, and precedes memory block with flag which indicate that the block is free.
Note: Functions like EM_blockErase are removed in AMS 2.xx to increase the life of the Flash ROM. Really, it is not necessary to erase a block psyhically. It is quite enough to mark it as "deleted", and it will be eventually simply be rewritten later.

Uses: EM_write, ROM Call 0x3CF
Used by: LIO_Receive, OSLinkCmd, FolderDel