Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: Interapplication Communication /
Chapter 6 - Resolving and Creating Object Specifier Records / Reference to Resolving and Creating Object Specifier Records
Routines for Resolving and Creating Object Specifier Records / Creating Object Specifier Records


CreateObjSpecifier

You can use the CreateObjSpecifier function to create an object specifier record.

FUNCTION CreateObjSpecifier (desiredClass: DescType; 
                             VAR theContainer: AEDesc; 
                             keyForm: DescType; 
                             VAR keyData: AEDesc; 
                             disposeInputs: Boolean; 
                             VAR objSpecifier: AEDesc): OSErr;
desiredClass
The object class of the desired Apple event objects.
theContainer
A description of the container for the requested object, usually in the form of another object specifier record.
keyForm
The key form for the object specifier record.
keyData
The key data for the object specifier record.
disposeInputs
A Boolean value indicating whether the function (TRUE) or your application (FALSE) should dispose of the descriptor records for the other parameters.
objSpecifier
The object specifier record created by the CreateObjSpecifier function.
DESCRIPTION
The CreateObjSpecifier function assembles an object specifier record from the specified constants and other descriptor records.

RESULT CODES
noErr0No error occurred
paramErr-50Error in parameter list
memFullErr-108Not enough room in heap zone
errAECoercionFail -1700Data could not be coerced to the requested Apple event data type
errAEWrongDataType-1703Wrong Apple event data type
errAENotAEDesc-1704Not a valid descriptor record
errAEBadListItem-1705Operation involving a list item failed
SEE ALSO
For information about how to assemble the components of an object specifier record with the CreateObjSpecifier function, see "Creating Object Specifier Records," which begins on page 6-64.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996