DAAppendFile
Document management, Direct access functionality
Descrição
Acrescenta ao documento qualquer alteração feita em um documento aberto originalmente com a função DAOpenFile. É uma operação rápida porque apenas os objetos alterados precisam ser adicionados ao final do arquivo original. O arquivo é fechado após esta operação e o file handle deixa de ser válido
Esta função não funcionará se o arquivo de origem foi aberto em modo somente leitura ou se o documento foi carregado de um arquivo malformado, por exemplo, quando whitespace foi adicionado ao início do arquivo. Nesses casos, a função DASaveAsFile deve ser usada em seu lugar
Sintaxe
Delphi
Function TPDFlib.DAAppendFile(FileHandle: Integer): Integer;
ActiveX
Function PDFlib::DAAppendFile(FileHandle As Long) As Long
DLL
int DLDAAppendFile(int InstanceID, int FileHandle);
Parâmetros
| 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. |