Legacy Document

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

noErr	0	No error occurred
paramErr	-50	Error in parameter list
memFullErr	-108	Not enough room in heap zone
errAECoercionFail	-1700	Data could not be coerced to the requested Apple event data type
errAEWrongDataType	-1703	Wrong Apple event data type
errAENotAEDesc	-1704	Not a valid descriptor record
errAEBadListItem	-1705	Operation 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.