DAAppendFile
Gestão de documentos, Funcionalidade de acesso direto
Descrição
Acrescenta quaisquer alterações efetuadas a um documento originalmente aberto com a função DAOpenFile. Esta é uma operação rápida porque apenas é necessário adicionar os objetos alterados ao fim do ficheiro original. O ficheiro é fechado após esta operação e o respetivo identificador deixa de ser válido
Esta função não funciona se o ficheiro de origem tiver sido aberto em modo só de leitura ou se o documento tiver sido carregado a partir de um ficheiro malformado, por exemplo, com espaços em branco adicionados no início. Nestes casos, deve utilizar a função DASaveAsFile
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 | Um identificador devolvido pelas funções DAOpenFile, DAOpenFileReadOnly ou DAOpenFromStream |
|---|
Valores devolvidos
| 0 | O FileHandle especificado não era válido As alterações ao ficheiro foram acrescentadas com êxito |
|---|---|
| 1 | 2 O ficheiro foi aberto no modo apenas de leitura e a atualização não pode ser gravada. Use DASaveAsFile em alternativa. 3 O documento foi aberto a partir de um ficheiro malformado e não é possível uma operação de anexação. Consulte a função DAShiftedHeader |