| Overview | Group | Index | Concepts | 
This is an advanced routine. Advanced routines typically demand a thorough understanding of the algorithms used by ILOG CPLEX. Thus they incur a higher risk of incorrect behavior in your application, behavior that can be difficult to debug. Therefore, ILOG encourages you to consider carefully whether you can accomplish the same task by means of other Callable Library routines instead.
The routine CPXgetincumbentcallbackfunc accesses the
 user-written callback to be called by CPLEX during MIP optimization after an
 integer solution has been found but before this solution replaces the
 incumbent. This callback can be used to discard solutions that do not meet
 criteria beyond that of the mixed integer programming formulation.
Example
CPXgetincumbentcallbackfunc(env, ¤t_incumbentcallback, ¤t_handle);
See also Advanced MIP Control Interface in the ILOG CPLEX User's Manual.
For documentation of callback arguments, see the routine 
 CPXsetincumbentcallbackfunc.
Parameters
env
A pointer to the CPLEX environment, 
 as returned by CPXopenCPLEX.
incumbentcallback_p
The address of the pointer to the current user-written incumbent callback. If no callback has been set, the pointer evaluates to NULL.
cbhandle_p
The address of a variable to hold the user's private pointer.
See Also: