This function creates and returns a search limit. Within this limit, the solver explores the search tree for only the number of choice points indicated by numOfChoicePts. After that limit has been reached, all remaining unexplored open nodes in the search tree are discarded.

When this function takes an instance of the class IloEnv as a parameter, it returns an instance of IloSearchLimit for use with the member functions IloSolver::startNewSearch and IloSolver::solve. An instance of IloSolver extracts the search limit that it returns as an instance of IlcSearchLimit for use during a Solver search.