This function supplies pointers to other Filter functions. When KV_GetFilterInterfaceEx()
is called, it assigns the function pointers in the structure KVFltInterfaceEx
to other functions described in this chapter. For example, KVFltInterfaceEx
.fpInit
is assigned to point to the function Init()
.
This is used as an entry point to Filter API versions 7.4 and higher.
KVErrorCode pascal KV_GetFilterInterfaceEx( KVFltInterfaceEx *pInterfaceEx, int version );
pInterfaceEx
|
A pointer to the structure KVFltInterfaceEx, which contains function pointers that KV_GetFilterInterfaceEx() assigns to all other API functions. |
version
|
The version number of the current Filter interface. This is a symbolic constant (KVFLTINTERFACE_REVISION ) defined in kvfilt.h . |
If the revision number of the Filter interface API is unknown, this function returns a general error (KVERR_General
).
KVFltInterfaceEx
structure and use this function to gain access to all other functions. The sample programs provide examples of how to do this. GetOLESummaryInfo()
instead of using fpGetOLESummaryInfo()
in KVFltInterfaceEx
. However, Micro Focus recommends that you assign the function pointers in KVFltInterfaceEx
to the functions for efficiency.void *pKVFILTER; KVFltInterfaceEx FilterFunc; KVErrorCode nRet = KVERR_Success; KVErrorCode (pascal *fpGetFilterInterfaceEx)( KVFltInterfaceEx *FilterFunc, int version ); pKVFILTER = myLoadLibrary(szDllName); fpGetFilterInterfaceEx = (KVErrorCode (pascal *)( KVFltInterfaceEx *, int ) ) myGetProcAddress(pKVFILTER, "KV_GetFilterInterfaceEx");
|