Initializing help system before first use

XSLPgetfuncobjectV

XSLPgetfuncobjectV


Purpose
Retrieve the address of one of the objects which can be accessed by the user functions
Synopsis
int XPRS_CC XSLPgetfuncobjectV(VARIANT *ArgInfo, int ObjType, void **Address)
Arguments
ArgInfo 
The array of argument information for the user function.
ObjType 
An integer indicating which object is to be returned. The following values are defined:
XSLP_XSLPPROBLEM 
The Xpress NonLinear problem pointer;
XSLP_XPRSPROBLEM 
The Xpress Optimizer problem pointer;
XSLP_GLOBALFUNCOBJECT 
The Global Function Object;
XSLP_USERFUNCOBJECT 
The User Function Object for the current function;
XSLP_INSTANCEFUNCOBJECT 
The Instance Function Object for the current instance;
Address 
Pointer to hold the address of the object.
Example
The following example retrieves the number of the function and the problem pointer. It then retrieves the internal name by which the function is known.
char fName[60];
int fNum;
XSLPprob Prob;
void *Object;

XSLPgetfuncinfoV(ArgInfo, NULL, NULL,
                NULL, NULL, NULL, NULL,
                &fNum, NULL);
XSLPgetfuncobjectV(ArgInfo, XSLP_XSLPPROBLEM, &Object);
Prob = (XSLPprob) Object;
XSLPgetnames(Prob, XSLP_USERFUNCNAMES, fName, fNum, fNum);
Further information

This function is identical to XSLPgetfuncobject except that ArgInfo is of type VARIANT rather than int. It is used in COM functions when the argument information array is passed as one of the arguments. To use this version of the function, pass the first member of array as the first argument to the function — e.g.
XSLPgetfuncobjectV(ArgInfo(0),......)

For functions which have no current instance because the function does not have instances, the Instance Function Object will be NULL.

For functions which have no current instance because the function was called directly from another user function, the Instance Function Object will be that set by the calling function.


Related topics