_GetHandSize( ) API Library Routine

See Also   Example

Returns the usable number of bytes associated with a specified memory block handle hand.

Syntax

unsigned long _GetHandSize(MHANDLE hand)
MHANDLE hand;            /* Handle of memory block. */

Remarks

The usable number of bytes is always greater than or equal to the number of bytes most recently requested for this MHANDLE by _AllocHand( ) or by a successful _SetHandSize( ) call.

Note   _GetHandSize( ) doesn't cause memory reorganization.

For more information on how to create an API library and integrate it with Visual FoxPro, see Chapter 28, Accessing the Visual FoxPro API, in the Programmer's Guide.