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
KVHTMLInterfaceEx2
structure 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 inKVHTMLInterfaceEx2
to the functions for efficiency. -
You must initialize
KVHTMLInterfaceEx2
by callingKVStructInit
prior to passing it toKVHTMLGetInterfaceEx2
, otherwiseKVHTMLGetInterfaceEx2
fails.
Example
KVHTMLInterfaceEx2 KVHTMLInt; BOOL (pascal *fpGetInterfaceEx2)(KVHTMLInterfaceEx2 *); ... KVStructInit(&KVHTMLInt); (*fpGetInterfaceEx2)(&KVHTMLInt);