Important: The information in this document is obsolete and should not be used for new development.
CreateObjSpecifier
You can use theCreateObjSpecifier
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
TheCreateObjSpecifier
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 theCreateObjSpecifier
function, see "Creating Object Specifier Records," which begins on page 6-64.