Carbon


PtrToXHand

Header: MacMemory.h Carbon status: Supported

Copies data referenced by a pointer to an existing relocatable block.

OSErr PtrToXHand (
    const void *srcPtr, 
    Handle dstHndl, 
    SInt32 size
);
Parameter descriptions
srcPtr

The address of the first byte to copy.

dstHndl

A handle to an existing relocatable block.

size

The number of bytes to copy.

function result

A result code. A result code.

DISCUSSION

The PtrToXHand function copies the specified number of bytes from the location specified by srcPtr to the handle specified by dstHndl.

Because PtrToXHand affects memory, you should not call it at interrupt time.

AVAILABILITY

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)