KVXMLGetInterfaceEx()
This function is exported by the Export definition file. It supplies function pointers to other Export functions. When KVXMLGetInterfaceEx() is called, it assigns the function pointers in the structure KVXMLInterfaceEx to other functions described in this chapter. For example, KVXMLInterfaceEx.fpInit is assigned to point to KVXMLInit().
Syntax
BOOL pascal KVXMLGetInterfaceEx (KVXMLInterfaceEx *pInterface);
Arguments
pInterface
|
A pointer to the structure KVXMLInterfaceEx. See KVXMLInterfaceEx. |
Returns
-
If the call is successful, the return value is
TRUE. -
If the call is unsuccessful, the return value is
FALSE.
If the function fails, all function pointers in pInterface are set to NULL.
You must initialize pInterface by calling KVStructInit prior to passing it to KVXMLGetInterfaceEx. If you do not do this, the function fails.
Discussion
-
One of the initial steps in using the XML Export API is to create an instance of a
KVXMLInterfaceExstructure and use this function to gain access to other functions. -
The functions can be called directly. For example, you can call
KVXMLGetSummaryInfo()instead of usingfpGetSummaryInfo()inKVXMLInterfaceEx. However, Micro Focus recommends that you assign the function pointers inKVXMLInterfaceExto the functions for efficiency. -
KVXMLInterfaceExmust be initialised by callingKVStructInitprior to passing it toKVXMLGetInterfaceEx, otherwiseKVXMLGetInterfaceExfails.
Example
KVXMLInterfaceEx KVXMLInt; BOOL (pascal *fpGetInterfaceEx)(KVXMLInterfaceEx *); ... KVStructInit(&KVXMLInt); (*fpGetInterfaceEx)(&KVXMLInt);