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

noErr	0	No error
memFullErr	-108	Not enough room in heap zone
errAEWrongDataType	-1703	Wrong descriptor type
errAENotAEDesc	-1704	Not a valid descriptor record
errAEBadListItem	-1705	Operation involving a list item failed