Important: The information in this document is obsolete and should not be used for new development.
AEGetObjectAccessor
You can use theAEGetObjectAccessor
function to get a pointer to an object accessor function and the value of its reference constant.
FUNCTION AEGetObjectAccessor (desiredClass: DescType; containerType: DescType; VAR theAccessor: AccessorProcPtr; VAR accessorRefcon: LongInt; isSysHandler: Boolean): OSErr;
desiredClass
- The object class of the Apple event objects located by the requested object accessor function. This parameter can also contain the constant
typeWildCard
or the constantcProperty
.containerType
- The descriptor type of the token that identifies the container for the objects located by the requested object accessor function. This parameter can also contain the constant
typeWildCard
.theAccessor
- The
AEGetObjectAccessor
function returns a pointer to the requested object accessor function in this parameter.accessorRefcon
- The
AEGetObjectAccessor
function returns the reference constant from the object accessor dispatch table entry for the specified object accessor function in this parameter.isSysHandler
- A value that specifies the object accessor table from which to get the object accessor function and its reference constant. If the value of
isSysHandler
isTRUE
,AEGetObjectAccessor
gets the function from the system object accessor dispatch table. If the value ofisSysHandler
isFALSE
,AEGetObjectAccessor
gets the function from the application's object accessor dispatch table.DESCRIPTION
TheAEGetObjectAccessor
function returns a pointer to the object accessor function installed for the object class specified in thedesiredClass
parameter and the descriptor type specified in thecontainerType
parameter. It also returns the reference constant associated with the specified function. You must supply a value in theisSysHandler
parameter that specifies which object accessor dispatch table you want to get the function from.Calling
AEGetObjectAccessor
does not remove the object accessor function from an object accessor dispatch table.To get 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 get 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, you must specifytypeWildCard
as the value of thecontainerType
parameter.To get 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