NO FRAMES

CPXgetincumbentcallbackfunc

void CPXPUBLIC CPXgetincumbentcallbackfunc(CPXCENVptr env, int(CPXPUBLIC **incumbentcallback_p)(CALLBACK_INCUMBENT_ARGS) , void ** cbhandle_p)
Definition file: cplex.h
Include files: cplex.h
Note

This is an advanced routine. Advanced routines typically demand a profound 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, &current_incumbentcallback,
 &current_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:

Returns:

This routine does not return a result.