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().
BOOL pascal KVXMLGetInterfaceEx (KVXMLInterfaceEx *pInterface);
pInterface
|
A pointer to the structure KVXMLInterfaceEx. See KVXMLInterfaceEx. |
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.
One of the initial steps in using the XML Export API is to create an instance of a KVXMLInterfaceEx structure and use this function to gain access to other functions.
The functions can be called directly. For example, you can call KVXMLGetSummaryInfo() instead of using fpGetSummaryInfo() in KVXMLInterfaceEx. However, Micro Focus recommends that you assign the function pointers in KVXMLInterfaceEx to the functions for efficiency.
KVXMLInterfaceEx must be initialised by calling KVStructInit prior to passing it to KVXMLGetInterfaceEx, otherwise KVXMLGetInterfaceEx fails.
KVXMLInterfaceEx KVXMLInt; BOOL (pascal *fpGetInterfaceEx)(KVXMLInterfaceEx *); ... KVStructInit(&KVXMLInt); (*fpGetInterfaceEx)(&KVXMLInt);
|
|