![]() |
AEInstallObjectAccessor |
||||
Header: | AEObjects.h | Carbon status: | Supported | |
Adds or replaces an entry for an object accessor function to an object accessor dispatch table.
OSErr AEInstallObjectAccessor ( DescType desiredClass, DescType containerType, OSLAccessorUPP theAccessor, SInt32 accessorRefcon, Boolean isSysHandler );
The object type of the Apple event objects located by this accessor.
The type of the token whose objects are accessed by this accessor. (Token is defined in AEDisposeToken.) The accessor function finds objects in containers specified by tokens of this type.
A universal procedure pointer to the object accessor function to install.
A reference constant the Apple Event Manager passes to the object accessor function whenever it calls the function. If your object accessor function doesnt expect a reference constant, pass 0 for this parameter. To change the value of the reference constant, you must call AEInstallObjectAccessor again.
Specifies the object accessor dispatch table to add the entry to. Pass TRUE to add the entry to the system object accessor dispatch table or FALSE to add the entry to your applications object accessor dispatch table. Use of the system object accessor dispatch table is not recommended for Carbon applications.
A result code.
The AEInstallObjectAccessor function adds or replaces an entry to either the application or system object accessor dispatch table.
A Carbon application should not install an object accessor in a system object accessor dispatch table with the goal that the accessor will get called when other applications resolve objectsthis wont necessarily work. See Apple Event Dispatching (to be supplied later) for more information. If your Carbon application running in Mac OS 8 or OS 9 installs a system object accessor function in its application heap, rather than in the system heap, you must call
Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)