Legacy Document

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

AEPutKeyDesc

You can use the AEPutKeyDesc function to add a descriptor record and a keyword to an AE record as a keyword-specified descriptor record.

FUNCTION AEPutKeyDesc (theAERecord: AERecord; 
                       theAEKeyword: AEKeyword; 
                       theAEDesc: AEDesc): OSErr;

theAERecord

The AE record to which to add the keyword-specified descriptor record.

theAEKeyword

The keyword specifying the descriptor record. If there was already a keyword-specified descriptor record with this keyword, it is replaced.

theAEDesc

The descriptor record 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