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 Items to Descriptor Lists

AEPutDesc

You can use the AEPutDesc function to add a descriptor record to any descriptor list.

FUNCTION AEPutDesc (theAEDescList: AEDescList; index: LongInt; 
                    theAEDesc: AEDesc): OSErr;

theAEDescList

The descriptor list to which to add a descriptor record.

index

The position of the descriptor record in the descriptor list. (For example, the value 2 specifies the second descriptor record in the list.) If there is already a descriptor record in the specified position, it is replaced. If the value of index is 0, the descriptor record is added to the end of the list.

theAEDesc

The descriptor record to be added to the list.

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
errAEIllegalIndex	-1719	Not a valid list index