fpInitWithLicenseData()
This function initializes an Export session with license information passed in function parameters rather than a license file. Its return value, pContext
, is passed as the first parameter to the File Extraction interface and all other Export functions.
This function is similar to fpInit(), but it uses a different licensing method. You can use either fpInit() or fpInitWithLicenseData
to initialize your Export session. However, these functions are mutually exclusive. That is, neither takes the context pointer from the other as an argument. If you call both functions, you initialize two distinct Export sessions, in the same way as calling fpInit() twice.
Syntax
void* pascal _export fpInitWithLicenseData( KVMemoryStream* pMemAllocator, char* pszKeyViewDir, const char* const pszLicenseOrganization const char* const pszLicenseKey char* pszDataFile, KVErrorCode* pError, DWORD dWord);
Arguments
|
This argument is deprecated in KeyView 12.10.0 and later, and should be |
|
A pointer to the directory where the Export components are located. This is normally the directory |
pszLicenseOrganization
|
A pointer to a string that contains the organization name under which this installation of KeyView is licensed. This value is the company name that appears at the top of the license key provided by Micro Focus. Add the text exactly as it appears in this file. |
pszLicenseKey
|
A pointer to a string that contains the license key for this installation of KeyView. This value is the appropriate license key provided by Micro Focus. The key is a string that contains 31 characters, for example 2TQD22D-2M6FV66-2KPF23S-2GEM5AB . Type these characters exactly as they appear in the license key file, including the dashes, but do not include any leading or trailing spaces. |
|
A pointer to the directory and file name of the Export data file, The |
|
A pointer to an error code defined in |
|
Reserved. Must be 0. |
Returns
-
If the call is successful, the return value is a pointer passed to all other functions.
-
If the call is unsuccessful, the return value is a
NULL
pointer.
Discussion
-
If
pszKeyViewDir
isNULL
, the required components cannot be found. Ensure that it is valid. -
If this function returns
NULL
, checkstderr
for the KeyView installation error messages, "KeyView Export SDK License Key has Expired
" and "KeyView Export SDK License Key is Invalid"
, and pass them to your application. See the Export SDK Installation Instructions for more information on the KeyView license feature. -
To ensure multithreaded conversions are thread-safe, you must create a unique context pointer for every thread by calling fpInit() or
fpInitWithLicenseData()
. In addition, threads must not share context pointers, and the same context pointer must be used for all API calls in the same thread. Creating a context pointer for every thread does not affect performance because the context pointer uses minimal resources. -
When the conversion context is no longer required, it should be terminated by calling fpShutDown().
-
On Windows,
pszKeyViewDir
andpszDataFile
must be in the local Windows code page.
Example
The following sample code is from the cnv2html
sample program:
pKVHTML = (*KVHTMLInt.fpInitWithLicenseData)(NULL, szDir, YOUR_LICENSE_ORGANIZATION, YOUR_LICENSE_KEY, NULL, &error, 0); if(!pKVHTML) { printf("Error initializing KVHTML: %d\n", error); mpFreeLibrary(hKVHTML); return 4; }