Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: Interapplication Communication /
Chapter 5 - Creating and Sending Apple Events / Reference to Creating and Sending Apple Events
Routines for Creating and Sending Apple Events / Adding Data and Descriptor Records to AE Records


AEPutKeyPtr

You can use the AEPutKeyPtr function to add a pointer to data, a descriptor type, and a keyword to an AE record as a keyword-specified descriptor record.

FUNCTION AEPutKeyPtr (theAERecord: AERecord; 
                      theAEKeyword: AEKeyword; 
                      typeCode: DescType; dataPtr: Ptr; 
                      dataSize: Size): OSErr;
theAERecord
The AE record to which to add a keyword-specified
descriptor record.
theAEKeyword
The keyword that identifies the descriptor record. If the AE record already includes a descriptor record with this keyword, it is replaced.
typeCode
The descriptor type for the keyword-specified descriptor record.
dataPtr
A pointer to the data for the keyword-specified descriptor record.
dataSize
The length, in bytes, of the data for the keyword-specified descriptor record.
RESULT CODES
noErr0No error
memFullErr-108Not enough room in heap zone
errAEWrongDataType-1703Wrong descriptor type
errAENotAEDesc-1704Not a valid descriptor record
errAEBadListItem-1705Operation involving a list item failed

Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996