![]() |
AEGetCoercionHandler |
||||
Header: | AEDataModel.h | Carbon status: | Supported | |
Gets the coercion handler for a specified descriptor type.
OSErr AEGetCoercionHandler ( DescType fromType, DescType toType, AECoercionHandlerUPP *handler, SInt32 *handlerRefcon, Boolean *fromTypeIsDesc, Boolean isSysHandler );
The descriptor type of the data coerced by the handler. For a list of AppleScripts predefined descriptor types, see
The descriptor type of the resulting data. For a list of AppleScripts predefined descriptor types, see
A universal procedure pointer. On return, a pointer to the specified handler, if a coercion table entry exists that exactly matches the values supplied in the parameters fromType and toType.
A pointer to a reference constant. On return, the reference constant from the coercion table entry for the specified coercion handler. The Apple Event Manager passes this reference constant to the handler each time it calls the handler. The reference constant may have a value of 0.
A pointer to a Boolean value. The AEGetCoercionHandler function returns a value of TRUE in this parameter if the coercion handler expects the data as a descriptor record or FALSE, if the coercion handler expects a pointer to the data.
Specifies the coercion table to get the handler from. Pass TRUE to get the handler from the system coercion table or FALSE to get the handler from your applications coercion table. Use of the system coercion table is not recommended for Carbon applications.
A result code.
A Carbon application should not install a coercion handler in a system coercion handler dispatch table with the goal that the handler will get called when other applications perform coercionsthis wont necessarily work. See Apple Event Dispatching (to be supplied later) for more information.
Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.
© 2000 Apple Computer, Inc. (Last Updated 5/8/2000)