Function

AERemoveObjectAccessor

Removes an object accessor function from an object accessor dispatch table.

Declaration

OSErr AERemoveObjectAccessor(DescType desiredClass, DescType containerType, OSLAccessorUPP theAccessor, Boolean isSysHandler);

Parameters

desiredClass

The object class of the Apple event objects located by the object accessor function to remove. Pass the value typeWildCard to remove an object accessor function whose entry in an object accessor dispatch table specifies typeWildCard as the object class. Pass the value cProperty 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). Some other possible values are defined in Object Class ID Constants. See DescType.

containerType

The descriptor type of the token that identifies the container for the objects located by the object accessor function to remove. (Token is defined in AEDisposeToken.) Pass the value typeWildCard to remove an object accessor function whose entry in an object accessor dispatch table specifies typeWildCard as the descriptor type of the token used to specify the container type. See DescType.

theAccessor

A universal procedure pointer to the special handler to remove. Although the functionClass parameter is sufficient to identify the handler to remove, you can identify the handler explicitly as a safeguard. If you pass NULL for this parameter, the Apple Event Manager relies solely on the function class to identify the handler. A universal procedure pointer (UPP) to the object accessor function to remove. Although the parameters desiredClass and containerType are sufficient to identify the function to remove, you can identify the function explicitly by providing a UPP in this parameter. If you pass NULL for this parameter, the Apple Event Manager relies solely on the desired class and container type. See OSLAccessorUPP.

isSysHandler

Specifies the object accessor dispatch table to remove the object accessor function from. Pass TRUE to remove the object accessor function from the system object accessor dispatch table or FALSE to remove the object accessor function from your application’s object accessor dispatch table. Use of the system object accessor dispatch table is not recommended.

Return Value

A result code. See Result Codes.

Discussion

In macOS, your application can not make an object callback function available to other applications by installing it in a system object accessor dispatch table.

See Also

Getting, Calling, and Removing Object Accessor Functions

AECallObjectAccessor

Invokes the appropriate object accessor function for a specific desired type and container type.

AEGetObjectAccessor

Gets an object accessor function from an object accessor dispatch table.

AEInstallObjectAccessor

Adds or replaces an entry for an object accessor function to an object accessor dispatch table.