Carbon


AEPutAttributePtr

Header: AEDataModel.h Carbon status: Supported

Adds a pointer to data, a descriptor type, and a keyword to an Apple event as an attribute.

OSErr AEPutAttributePtr (
    AppleEvent *theAppleEvent, 
    AEKeyword theAEKeyword, 
    DescType typeCode, 
    const void *dataPtr, 
    Size dataSize
);
Parameter descriptions
theAppleEvent

A pointer to the Apple event to add an attribute to.

theAEKeyword

The keyword for the attribute to add. If the Apple event already includes an attribute with this keyword, the attribute is replaced.

Some keyword constants are described in “Keyword Attribute Constants”.

typeCode

The descriptor type for the attribute to add. For a list of AppleScript’s predefined descriptor types, see “Descriptor Type Constants”.

dataPtr

A pointer to the data for the attribute to add.

dataSize

The length, in bytes, of the data for the attribute to add.

function result

A result code.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)