DAAppendFile
Document management, Direct access functionality
Description
Appends any changes made to a document originally opened using the DAOpenFile function. This is a fast operation because only the changed objects must be added to the end of the original file. The file is closed after this operation and the file handle will no longer be valid.
This function will not work if the source file was opened in read only mode or if the document was loaded from a malformed file for example where whitespace was added to the start of the file. In these cases the DASaveAsFile function should be used instead.
Syntax
Delphi
function TPDFlib.DAAppendFile(FileHandle: Integer): Integer;ActiveX
Function PDFlib::DAAppendFile(FileHandle As Long) As LongDLL
int DLDAAppendFile(int InstanceID, int FileHandle);Parameters
| FileHandle | A handle returned by the DAOpenFile, DAOpenFileReadOnly or DAOpenFromStream functions |
|---|
Return values
| 0 | The specified FileHandle was not valid The changes to the file were appended successfully |
|---|---|
| 1 | 2 The file was opened in read only mode and the update cannot be written. Use DASaveAsFile instead. 3 The document was opened from a malformed file and an append operation is not possible. See the DAShiftedHeader function. |