fpOpenDocumentFromFile()
Creates a KVDocument from a file.
The KVDocument type is an opaque pointer that represents a single document. You can pass the KVDocument into other functions in the Filter API to perform operations with that document.
Syntax
KVErrorCode (pascal* fpOpenDocumentFromFile)(
KVFilterSession session,
const char* szInputFile,
KVDocument* ppDocument);
Arguments
session
|
A Filter session that you initialized by calling fpInit(). |
szInputFile
|
A pointer to a string that contains the path of the file. On Windows, the path must be encoded in the local Windows code page. |
ppDocument
|
A pointer to a KVDocument. |
Returns
The return value is an error code.
- If the call is successful, the return value is
KVError_Successand theKVDocumentis stored in*ppDocument. - If the call is unsuccessful, the return value is an error code and
*ppDocumentis set toNULL.
Lifetimes and Memory Management
- If the function returns
KVError_Success, when you have finished with theKVDocumentthat was returned in*ppDocument, you must call fpCloseDocument() to free the memory that was allocated by this function. - The Filter session must outlive the
KVDocumentcreated by this function. In other words, you must call fpCloseDocument() on theKVDocumentbefore calling fpShutdown() on the Filter session (session) that was used to create it.
Example
The following example demonstrates the creation of a KVDocument from a file.
KVDocument pDocument = NULL; error = fpOpenDocumentFromFile(session, szInputFile, &pDocument);