DAOpenMappedFile

Dokumenthåndtering, direkte adgangsfunktioner, ydeevne

Beskrivelse

Åbner en lokal PDF til Direct Access gennem en afgrænset, skrivebeskyttet afbildet visning uden at holde hele filen i hukommelsen

Syntaks

Delphi

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

Parametre

InputFileNameStien til den lokale PDF
PasswordDokumentets adgangskode, eller en tom streng, når PDF'en ikke er krypteret
WindowSizeDen ønskede størrelse af den afbildede visning i bytes; nul vælger 64 MiB, og den effektive værdi justeres og begrænses til højst 1 GiB
OptionsNul tillader en fallback til skrivebeskyttet filstream, mens PDF_MAPPED_FILE_REQUIRE_MAPPING kræver en aktiv afbildet visning

Returværdier

>0Et Direct Access-dokumenthandle
0Argumenterne, filen, adgangskoden, mappingkravet eller PDF-strukturen var ugyldige; undersøg LastErrorCode

Bemærkninger

Det returnerede handle ejer den afbildede kilde og frigiver sine visnings- og filhandles, når det sendes til DACloseFile

Det gemte vindue omabilderes efter behov til side-, objekt- og strømlæsninger; alle læsninger forbliver begrænset af filens fysiske størrelse

Brug DAGetMappedFileInfo til at se kilde- og genafbildningsstatistik for handlet