Important: The information in this document is obsolete and should not be used for new development.
AERemoveObjectAccessor
You can use theAERemoveObjectAccessor
function to remove an object accessor function from an object accessor dispatch table.
FUNCTION AERemoveObjectAccessor (desiredClass: DescType; containerType: DescType; theAccessor: AccessorProcPtr; isSysHandler: Boolean): OSErr;
desiredClass
- The object class of the Apple event objects located by the object accessor function. The
desiredClass
parameter can also contain the constanttypeWildCard
or the constantcProperty
.containerType
- The descriptor type of the token that identifies the container for the objects located by the object accessor function. The
containerType
parameter can also contain the constanttypeWildCard
.theAccessor
- A pointer to the object accessor function you want to remove. Although the parameters
desiredClass
andcontainerType
would be sufficient to identify the function to be removed, providing the parametertheAccessor
guarantees that you remove the correct function. If this parameter does not contain a pointer to the object accessor function you want to remove, its value should beNIL
.isSysHandler
- A value that specifies the object accessor dispatch table from which to remove the object accessor function. If the value of
isSysHandler
isTRUE
,AEGetObjectAccessor
removes the routine from the system object accessor dispatch table. If the value isFALSE
,AEGetObjectAccessor
removes the routine from the application object accessor dispatch table.DESCRIPTION
TheAERemoveObjectAccessor
function removes the object accessor function you have installed for the object class specified in thedesiredClass
parameter and the descriptor type specified in thecontainerType
parameter.To remove an object accessor function whose entry in an object accessor dispatch table specifies
typeWildCard
as the object class, you must specifytypeWildCard
as the value of thedesiredClass
parameter. Similarly, to remove an object accessor function whose entry in an object accessor dispatch table specifiestypeWildCard
as the descriptor type of the token used to specify the container for the desired objects, you must specifytypeWildCard
as the value of thecontainerType
parameter.To remove an object accessor function whose entry in an object accessor dispatch table specifies
cProperty
(a constant used to specify a property of any object class), you must specifycProperty
as thedesiredClass
parameter.RESULT CODES