Open topic with navigation

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

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 using fpGetSummaryInfo() in KVHTMLInterfaceEx2. However, HPE recommends that you assign the function pointers in KVHTMLInterfaceEx2 to the functions for efficiency.

• You must initialize KVHTMLInterfaceEx2 by calling KVStructInit prior to passing it to KVHTMLGetInterfaceEx2, otherwise KVHTMLGetInterfaceEx2 fails.

  Example

  KVHTMLInterfaceEx2 KVHTMLInt;
  BOOL (pascal *fpGetInterfaceEx2)(KVHTMLInterfaceEx2 *);
  ...
  KVStructInit(&KVHTMLInt);
  (*fpGetInterfaceEx2)(&KVHTMLInt);