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
| InputFileName | O caminho do PDF local |
|---|---|
| Password | A senha do documento, ou uma string vazia quando o PDF não é criptografado |
| WindowSize | O tamanho solicitado da visão 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 arquivo somente leitura, enquanto PDF_MAPPED_FILE_REQUIRE_MAPPING exige uma visão mapeada ativa |
Valores retornados
| >0 | Um handle de documento de acesso direto |
|---|---|
| 0 | Os 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