![]() |
PtrAndHand |
||||
Header: | MacMemory.h | Carbon status: | Supported | |
Concatenates part or all of a memory block to the end of a relocatable block.
OSErr PtrAndHand ( const void *ptr1, Handle hand2, SInt32 size );
A pointer to the beginning of the data that the Memory Manager is to concatenate onto the end of the relocatable block.
A handle to the relocatable block, whose size the Memory Manager expands so that it can concatenate the information from ptr1 onto the end of this block.
The number of bytes of the block referenced by ptr1 to copy.
A result code. A result code.
The PtrAndHand function takes the number of bytes specified by the size parameter, beginning at the location specified by ptr1, and concatenates them onto the end of the relocatable block to which hand2 is a handle. The contents of the source block remain unchanged.
Because PtrAndHand allocates memory, you should not call it at interrupt time.
Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)