KVHTMLGetInterfaceEx2()
This function is exported by the Export definition file. It supplies function pointers to other Export functions. When KVHTMLGetInterfaceEx2() is called, it assigns the function pointers in the structure KVHTMLInterfaceEx2 to other functions described in this chapter. For example, KVHTMLInterfaceEx2.fpInit is assigned to point to KVHTMLInitEx().
Syntax
BOOL pascal KVHTMLGetInterfaceEx2 (KVHTMLInterfaceEx2 *pInterface);
Arguments
pInterface
|
A pointer to the structure KVHTMLInterfaceEx2. See KVHTMLInterfaceEx2. |
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 KVHTMLGetInterfaceEx2. If you do not do this, the function fails.
Discussion
- One of the initial steps in using the HTML Export API is to create an instance of a
KVHTMLInterfaceEx2structure and use this function to gain access to other functions. - The API functions can be called directly. For example, you can call
KVHTMLGetSummaryInfo()instead of usingfpGetSummaryInfo()inKVHTMLInterfaceEx2. However, Micro Focus recommends that you assign the function pointers inKVHTMLInterfaceEx2to the functions for efficiency. -
You must initialize
KVHTMLInterfaceEx2by callingKVStructInitprior to passing it toKVHTMLGetInterfaceEx2, otherwiseKVHTMLGetInterfaceEx2fails.
Example
KVHTMLInterfaceEx2 KVHTMLInt; BOOL (pascal *fpGetInterfaceEx2)(KVHTMLInterfaceEx2 *); ... KVStructInit(&KVHTMLInt); (*fpGetInterfaceEx2)(&KVHTMLInt);