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 / Resolving Object Specifier Records


AEResolve

You can use the AEResolve function to resolve an object specifier record in an Apple event parameter.

FUNCTION AEResolve (objectSpecifier: AEDesc; 
                    callbackFlags: Integer; 
                    VAR theToken: AEDesc): OSErr;
objectSpecifier
The object specifier record to be resolved.
callbackFlags
A value that determines what additional assistance, if any, your application can give the Apple Event Manager when it parses the object specifier record. The value is specified by adding the following constants, as appropriate:
            CONST    kAEIDoMinimum  = $0000;    {supports minimum }
                                                { callbacks only}
                     kAEIDoWhose    = $0001;    {supports formWhose}
                     kAEIDoMarking  = $0004;    {provides marking }
                                                { functions} 
theToken
The AEResolve function returns, in this parameter, a token that identifies the Apple event objects specified by the objectSpecifier parameter. Your object accessor functions may need to create many tokens to resolve a single object specifier record; this parameter contains only the final token that identifies the requested Apple event object. If an error occurs, AEResolve returns a null descriptor record.
DESCRIPTION
The AEResolve function resolves the object specifier record passed in the objectSpecifier parameter with the help of the object accessor functions and object callback functions provided by your application.

RESULT CODES
noErr0No error occurred
paramErr-50AEObjectInit was not called before this function was called
errAEHandlerNotFound-1717The necessary object callback function was not found (this result is returned only for object callback functions; errAEAccessorNotFound [-1723] is returned when an object accessor function is not found)
errAEImpossibleRange-1720The range is not valid because it is impossible for a range to include the first and last objects that were specified; an example is a range in which the offset of the first object is greater than the offset of the last object
errAEWrongNumberArgs-1721The number of operands provided for the kAENOT logical operator is not 1
errAEAccessorNotFound-1723There is no object accessor function for the specified object class and token descriptor type
errAENoSuchLogical-1725The logical operator in a logical descriptor record is not kAEAND, kAEOR, or kAENOT
errAEBadTestKey-1726The descriptor record in a test key is neither a comparison descriptor record nor a logical descriptor record
errAENotAnObjectSpec-1727The objSpecifier parameter of AEResolve is not an object specifier record
errAENegativeCount-1729An object-counting function returned a negative result
errAEEmptyListContainer-1730The container for an Apple event object is specified by an empty list
In addition to the result codes listed here, AEResolve also returns any result code returned by one of your application's object accessor functions or object callback functions. For example, an object accessor function can return errAENoSuchObject (-1728) when it can't find an Apple event object, or it can return more specific result codes.

If any object accessor function or object callback function returns a result code other than noErr or errAEEventNotHandled, AEResolve immediately disposes of any existing tokens and returns. The result code it returns in this case is the result code returned by the object accessor function or the object callback function.

SEE ALSO
For an overview of the way AEResolve works with object accessor functions, see "Resolving Object Specifier Records," which begins on page 6-4.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996