![]() |
AEPutPtr |
||||
Header: | AEDataModel.h | Carbon status: | Supported | |
Puts data specified in a buffer to a descriptor list as a descriptor record, possibly replacing an existing record in the list.
OSErr AEPutPtr ( AEDescList *theAEDescList, SInt32 index, DescType typeCode, const void *dataPtr, Size dataSize );
A pointer to the descriptor list to add a descriptor record to.
A one-based positive integer indicating the position to insert the descriptor record at. If there is already a descriptor record in the specified position, it is replaced.
You can pass a value of zero or count + 1 to add the descriptor record at the end of the list. AEPutPtr returns an error (AEIllegalIndex) if you pass a negative number or a value that is out of range.
The descriptor type for the descriptor record to be put into the list. For a list of AppleScripts predefined descriptor types, see
A pointer to the data for the descriptor record to add.
The length, in bytes, of the data for the descriptor record to add.
A result code.
Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.
© 2000 Apple Computer, Inc. (Last Updated 5/8/2000)