MBM.FlatUpdate (FUN)

( ⇘ CAA_MemBlockMan.Library)

The value belonging to key idKey will be replaced by hMsg. The value which has been valid before calling this function will be returned in hOldMsg and can now possible be deallocated via MBM.MsgRelease. If the value could not be refreshed or if so far no value had been entered into the Flat, CAA.gc_hINVALID will be returned.

Input:

hFlat	CAA.HANDLE	Flat Handle
idKey	CAA.IDENT	Key for which the value should be refreshed.
hMsg	CAA.HANDLE	Handle of the new message.
peError	POINTER TO MBM.ERROR	Pointer on error ID.

Output:

hOldMsg

CAA.HANDLE

Handle of the message which was stored in the Flat previously.