fpInit()

This function initializes an Export session. Its return value, pContext, is passed as the first parameter to the File Extraction interface and all other Export functions.

Syntax

void* pascal _export fpInit(
    KVMemoryStream    *pMemAllocator,
    char              *pszKeyViewDir,
    char              *pszDataFile,
    KVErrorCode       *pError,
    DWORD              dWord);

Arguments

pMemAllocator

A pointer to a developer-defined memory allocator. If NULL is passed, the default C run-time memory allocation is used.

pszKeyViewDir

A pointer to the directory where the Export components are located. This is normally the directory install\OS\bin, where install is the path name of the Export installation directory and OS is the name of the operating system.

pszDataFile

A pointer to the directory and file name of the Export data file, formats_e.ini. This file determines whether a format is supported. If a format does not exist in this file, the conversion fails.

The formats_e.ini file is normally stored in the directory install\OS\bin, where install is the path name of the Export installation directory and OS is the name of the operating system. See File Format Detection for more information.

pError

A pointer to an error code defined in KVErrorCode or KVErrorCodeEx in kvtypes.h. See KVErrorCode and KVErrorCodeEx.

dWord

Reserved. Must be 0.

Returns

Discussion

Example

The following sample code is from thecnv2xml sample program:

pKVXML = (*KVXMLInt.fpInit)(NULL, ".", NULL, &error, 0);
if(!pKVXML)
   {
      printf("Error initializing KVXML: %d\n", error);
      mpFreeLibrary(hKVXML);
      return 4;
   }

_HP_HTML5_bannerTitle.htm