iNetGrowX

iNetGrowX is an ActiveX component that gives you access to the iNetGrow system through its various member functions. If you run a web server, then you can quickly implement pages with content taken from the iNetGrow system. For instance, you may allow users to view and modify parameters from a web page or view the current values of your inputs and outputs. In such cases, since the user interacts with the iNetGrow system through a browser, any device anywhere on the Internet gives you access to the iNetGrow system. You may use a web-enabled cell phone to change view or parameters while you are out of town.

iNetGrowX Functions

The following table shows the functions of iNetGrowX. Typically, you connect to a controller and then retrieve the number if inputs, outputs, variables, and parameters. There are functions to retrieve the names and values of these. In addition, there is a function to set the value of the parameters. The index is zero-based. For example, if there are N inputs, you address each individual input by an index in the range 0 to (N-1).

VT_I4 Connect(BSTR bstrURL, VT_I4 nPort);
bstrURL	The address of the controller to which you want to connect. This could be an IP address such as “192.168.0.65” or a URL such as “mycontroller.inetgrow.com”.
nPort	iNetGrow uses UDP port 8448.
return value	TRUE (nonzero) or FALSE (0).

VT_I4 GetNumInputs(VT_I4 boolReloadValues);
boolReloadValues	TRUE (nonzero) if you want to reload (upload) all of the information from the controller. If zero, then the information from most recent upload is used.
return value	Number of inputs.

BSTR GetInputName(VT_I4 nIndex);
nIndex	Zero-based index of input.
return value	Name of the input.

VT_I4 GetInputValue(VT_I4 nIndex);
nIndex	Zero-based index of input.
return value	Value of the input.

VT_I4 GetNumOutputs(VT_I4 boolReloadValues);
boolReloadValues	TRUE (nonzero) if you want to reload (upload) all of the information from the controller. If zero, then the information from most recent upload is used.
return value	Number of outputs.

BSTR GetOutputName(VT_I4 nIndex);
nIndex	Zero-based index of output.
return value	Name of the output.

VT_I4 GetOutputValue(VT_I4 nIndex);
nIndex	Zero-based index of output.
return value	Value of the output.

VT_I4 GetNumVariables(VT_I4 boolReloadValues);
boolReloadValues	TRUE (nonzero) if you want to reload (upload) all of the information from the controller. If zero, then the information from most recent upload is used.
return value	Number of variables.

BSTR GetVariableName(VT_I4 nIndex);
nIndex	Zero-based index of variable.
Name of the input.	Name of the variable.

VT_I4 GetVariableValue(VT_I4 nIndex);
nIndex	Zero-based index of variable.
return value	Value of the variable.

VT_I4 GetNumParameters(VT_I4 boolReloadValues);
boolReloadValues	TRUE (nonzero) if you want to reload (upload) all of the information from the controller. If zero, then the information from most recent upload is used.
return value	Number of iparameters.

BSTR GetParameterName(VT_I4 nIndex);
nIndex	Zero-based index of parameter.
Name of the input.	Name of the parameter.

VT_I4 GetParameterValue(VT_I4 nIndex);
nIndex	Zero-based index of parameter.
return value	Value of the parameter.

VT_I4 VT_I4 SetParameterValue(VT_I4 nIndex, VT_I4 nValue);
nIndex	Zero-based index of parameter.
nValue	New Value of the parameter.
return value	TRUE (nonzero) if successful, FALSE (zero) otherwise.

An example is provided in the section “Active Service Pages with iNetGrowX.” Also see the section “Integrating with Web Services.”