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.

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.

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 KVXMLInterfaceEx structure and use this function to gain access to other functions.

  • KVXMLInterfaceEx must be initialised by calling KVStructInit prior to passing it to KVXMLGetInterfaceEx, otherwise KVXMLGetInterfaceEx fails.

Example

KVXMLInterfaceEx KVXMLInt;
BOOL (pascal *fpGetInterfaceEx)(KVXMLInterfaceEx *);
...
KVStructInit(&KVXMLInt);
(*fpGetInterfaceEx)(&KVXMLInt);