AEPutKeyPtr

Create keyword-specified descriptor record from pointer

#include <AppleEvents.h> Apple Event Manager

OSErr AEPutKeyPtr( theAERecord, theAEKeyword, typeCode, dataPtr,

dataSize );

AERecord * theAERecord ; AE record to which to add a keyword- specified

descriptor record

AEKeyword theAEkeyword ; Apple Event keyword

DescType typeCode ; descriptor type of created record

Ptr dataPtr ; pointer to record created

Size dataSize ; size of record created

returns Error Code; 0 = no error

The AEPutKeyPtr function takes a pointer to data, a descriptor type, and a

keyword and converts them into a keyword-specified descriptor record that it

adds to an AE record.

The parameter theAERecord is the AE record to which to add a

keyword-specified descriptor record.

The parameter theAEKeyword is the keyword specifying the descriptor

record. If there was already a descriptor record with this keyword, it is

replaced.

The typeCode parameter is the descriptor type for the keyword- specified

descriptor record.

The dataPtr parameter is a pointer to the data for the keyword- specified

descriptor record.

The dataSize parameter is 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

Referenced by (2):