CPXXgettuningcallbackfunc and CPXgettuningcallbackfunc

Accesses the user-written legacy callback routine to be called before each trial run during the tuning process.

int  CPXXgettuningcallbackfunc( CPXCENVptr env, int(CPXPUBLIC **callback_p)(CPXCENVptr, void *, int, void *), void ** cbhandle_p )

int  CPXgettuningcallbackfunc( CPXCENVptr env, int(CPXPUBLIC **callback_p)(CPXCENVptr, void *, int, void *), void ** cbhandle_p )

Description

The routine CPXXgettuningcallbackfunc/CPXgettuningcallbackfunc accesses the user-written legacy callback routine to be called before each trial run during the tuning process.

For documentation of the user-written tuning callback function, see CPXXsettuningcallbackfunc and CPXsettuningcallbackfunc.

Tip:

This routine is part of legacy callbacks. Do not use this routine with a generic callback in your application. For more about generic callbacks, see the topic Generic callbacks in the CPLEX User's Manual.

Arguments

env

A pointer to the CPLEX environment as returned by CPXXopenCPLEX/CPXopenCPLEX.

callback_p

The address of the pointer to the current user-written callback function. If no callback function has been set, the pointer evaluates to NULL.

cbhandle_p

The address of a variable to hold the user's private pointer.

Return

The routine returns 0 (zero) if successful and nonzero if an error occurs.

Example


status = CPXgettuningcallbackfunc (env, mycallback, NULL);