Important: The information in this document is obsolete and should not be used for new development.
CallComponentFunction
TheCallComponentFunction
function invokes a specified function of your component with the parameters originally provided by the application that called
your component. You pass these parameters by specifying the same component parameters record passed to your component's main entry point.
FUNCTION CallComponentFunction (params: ComponentParameters; func: ComponentFunction): LongInt;
params
- The component parameters record that your component received from the Component Manager.
func
- The address of the function that is to handle the request. The Component Manager calls the routine referred to by the
func
parameter as a Pascal function with the parameters that were originally provided by the application. The routine referred to by this parameter must return a function result of typeComponentResult
(a long integer) indicating the success or failure of the operation.DESCRIPTION
CallComponentFunction
returns the value that is returned by the routine referred to by thefunc
parameter. Your component should use this value to set the current error for this connection.SPECIAL CONSIDERATIONS
If your component subroutine does not need global data, your component should useCallComponentFunction
. If your component subroutine requires memory in which to store global data for the component, your component must useCallComponentFunctionWithStorage
, which is described next.SEE ALSO
For an example that usesCallComponentFunction
, see Listing 6-5 on page 6-16. You can use theSetComponentInstanceError
procedure, described on page 6-67, to set the current error.