>>-#--pragma--cancel_handler------------------------------------> >--(--function_name--+-,--0--------+--)------------------------>< '-,--com_area-'
Description
Specifies that the function named is to be enabled as a user-defined ILE cancel handler at the point in the code where the #pragma cancel_handler directive is located.
Any cancel handler that is enabled by a #pragma cancel_handler directive is implicitly disabled when the call to the function containing the directive is finished. The call is removed from the call stack, if the handler has not been explicitly disabled by the #pragma disable_handler directive.
Parameters
See the Run-Time Library Reference for information about <except.h> and the typedef _CNL_Hndlr_Parms_T, a pointer which is passed to the cancel handler.
Notes on Usage
The handler function can take only 16-byte pointers as parameters.
This #pragma directive can only occur at a C language statement boundary and inside a function definition.
The compiler issues an error message if any of the following occurs:
See the WebSphere Development Studio: ILE C/C++ Programmer's Guide for examples and more information about using the #pragma cancel_handler directive.
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.