DAOpenMappedFile
Gestão de documentos, funcionalidade de acesso direto, desempenho
Descrição
Abre um PDF local para acesso direto através de uma vista mapeada só de leitura e delimitada, sem reter o ficheiro completo em memória
Sintaxe
Delphi
Function TPDFlib.DAOpenMappedFile(Const InputFileName, Password: WideString;
WindowSize: Int64= 0; Options: Integer= 0): Integer;Parâmetros
| InputFileName | O caminho do PDF local |
|---|---|
| Password | A senha do documento, ou uma cadeia vazia quando o PDF não está encriptado |
| WindowSize | O tamanho pedido da vista mapeada em bytes; zero seleciona 64 MiB e o valor efetivo é alinhado e limitado a 1 GiB |
| Options | Zero permite um fallback de fluxo de ficheiro só de leitura, enquanto PDF_MAPPED_FILE_REQUIRE_MAPPING exige uma vista mapeada ativa |
Valores devolvidos
| >0 | Um handle de documento de acesso direto |
|---|---|
| 0 | Os argumentos, o ficheiro, a senha, a exigência de mapeamento ou a estrutura PDF eram inválidos; inspecione LastErrorCode |
Observações
O identificador devolvido é proprietário da origem mapeada e liberta a respetiva vista e identificadores de ficheiro quando transmitido a DACloseFile
A janela retida é remapeada a pedido para leituras de páginas, objetos e fluxos; todas as leituras permanecem limitadas pelo tamanho físico do ficheiro
Utilize DAGetMappedFileInfo para inspecionar estatísticas de origem e de remapeamento do identificador