DAOpenMappedFile

Gerenciamento de documentos, Funcionalidade de acesso direto, Desempenho

Descrição

Abre um PDF local para acesso direto por meio de uma visão mapeada somente leitura limitada, sem reter o arquivo completo na memória

Sintaxe

Delphi

Function TPDFlib.DAOpenMappedFile(Const InputFileName, Password: WideString;
  WindowSize: Int64= 0; Options: Integer= 0): Integer;

Parâmetros

InputFileNameO caminho do PDF local
PasswordA senha do documento, ou uma string vazia quando o PDF não é criptografado
WindowSizeO tamanho solicitado da visão mapeada em bytes; zero seleciona 64 MiB e o valor efetivo é alinhado e limitado a 1 GiB
OptionsZero permite um fallback de fluxo de arquivo somente leitura, enquanto PDF_MAPPED_FILE_REQUIRE_MAPPING exige uma visão mapeada ativa

Valores retornados

>0Um handle de documento de acesso direto
0Os argumentos, o arquivo, a senha, o requisito de mapeamento ou a estrutura do PDF eram inválidos; examine LastErrorCode

Observações

O handle retornado é dono da origem mapeada e libera a view e os handles de arquivo quando passado a DACloseFile

A janela retida é remapeada sob demanda para leituras de página, objeto e stream; todas as leituras permanecem limitadas ao tamanho físico do arquivo

DAGetMappedFileInfo para examinar estatísticas de origem e remapeamento do handle