Community articleIFXGetInterfaceInstances function
Added by IBM contributorIBM on May 2, 2012
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

No abstract provided.



Description

Returns a list of FunctionCall structures that are currently registered with the IFX Manager.

Function

r_short IFXGetInterfaceInstances(
   IFX *theIFXManager,
   r_charP theInterfaceName,
   r_u_long theInterfaceVersion,
   GenericInterface ***theInterfaceListPtr,
   r_long *theInterfaceListSizePtr);


Parameters

Table 1. get interface instances parameters
ExpressionTypeDescription
theIFXManagerIFX*The IFX Manager for your application.
theInterfaceName r_charPThe name of the interface that you are looking for. In this case the Function Call Interface.
theInterfaceVersion r_u_longThe Function Call Interface version.
theInterfaceListPtrGenericInterface***A pointer to the Generic Interface List that contains all of the instances of the interface specified in theInterfaceName. Note Typically the Generic Interface instances in the list must be typecast to type FunctionCall.
theInterfaceListSizePtrr_long*Points to the size of the Generic Interface List.


Returns

OK on success or an error code on failure.

Example

GenericInterface **theFunctionCallList;
r_long *theNumOfFunctionCalls;
FunctionCall theFunctionCall;
      if (theError = (IFXGetInterfaceInstances(theIFXMangager,
         FUNCTIONCALL_INTERFACE_NAME, FUNCTIONCALL_CURRENT_VERSION,
         &theFunctionCallList,theNumOfFunctionCalls)) != OK)
      {
         return theError;
      }
      for(int i = 0 ; i < *theNumberOfFunctionCalls; i++)
      {
         theFunctionCall = (FunctionCall*)theFunctionCallList [i];
      }