BltMemoGetSize


< Prev  TOC  Next >

TBLT_RETC TBLT_ENTRY BltMemoGetSize(TBLT_DH *dhPtr,
                                    ULONG memoNo,
                                    ULONG *availLinkPtr,
                                    ULONG *memoSizePtr);


 dhPtr          I:data file control structure
 memoNo         I:memo number to get
 availLinkPtr   O:availLink value
 memoSizePtr    O:size of memo data, in bytes

This routine returns the number of bytes stored at memoNo.

For active memos, the availLink value is always 0x8FFFF (or the value in TBLT_DH.memoInUseFlag). The memo size is the size that was set by the programmer when storing or updating the memo record.

If the memo is deleted the availLink is a memo block number to the next available memo block in the reuse memo avail chain. The size is the total number of bytes that the deleted block(s) uses, including the eight bytes of overhead of the first block. This size is always a multiple of the TBLT_DH.memoBlockSize (default=512) in Bullet 3. (Bullet 2 stored deleted memo sizes differently; see the supplemental documentation on how to manage Bullet 2 memo files with deleted memos in them.) The return code is EXB_MEMO_DELETED.

Return: Non-zero indicates an error (or a deleted memo), otherwise the availLink and size are returned.


All content Copyright © 1999 Cornel Huth. All rights reserved.