DAOpenFromURL

Dokumenthåndtering, direkte tilgangsfunksjonalitet

Beskrivelse

Åpner en ekstern PDF over HTTP for direkte tilgang ved bruk av byte-intervall-forespørsler

Transporten sonderer URL-en én gang for å bekrefte støtte for byte-intervall og lære total lengden, og en søkbar strøm driver så den eksisterende tilfeldig tilgangs-leseren slik at bare objektene som faktisk leses hentes over nettverket

Når dokumentet er linearisert og cache-opvarming er aktivert, forhåndshentes førsteside-seksjonen innenfor budsjettet for beholdte byte slik at side 1 renderes før resten av filen berøres

Syntaks

Delphi

Function TPDFlib.DAOpenFromURL(Const URL, Password: WideString; Options: Integer= 0; ChunkSize: LongInt= 0; CacheLimitBytes: Int64= 0; CoalesceWindowMS: Cardinal= PDF_NET_DEFAULT_COALESCE_WINDOW_MS): Integer;

DLL

int DLDAOpenFromURL(int InstanceID, const wchar_t* URL, const wchar_t* Password, int Options);

ActiveX

Function PDFlib::DAOpenFromURL(URL As String, Password As String, Options As Long) As Long

Parametere

URL	http- eller https-adressen til den eksterne PDF-en
Password	Dokumentpassordet, eller en tom streng når PDF-en ikke er kryptert
Options	Null for standardåpning med oppvarmet førsteside, eller `PDF_NET_OPT_NO_WARMING` for å åpne rent på forespørsel
ChunkSize	Kun Delphi; granularitet for justert henting av områder, der null gir 64 KiB
CacheLimitBytes	Kun Delphi; maksimalt antall lagrede kildebyter, der null gir 4 MiB og verdier under én blokk heves til én blokk
CoalesceWindowMS	Kun Delphi; samlingsvinduet for den første blokken som ikke er i hurtiglageret ved hver absolutte lesing, med 2 millisekunder som standard, og null deaktiverer den innledende forsinkelsen

Returverdier

>0	Et dokumenthåndtak med direkte tilgang
0	Dokumentet kunne ikke åpnes; `LastErrorCode` settes til `PDFLIB_ERROR_NET_OPEN`, `PDFLIB_ERROR_NET_RANGE_UNSUPPORTED`, `PDFLIB_ERROR_NET_HTTP` eller en kode for struktur eller passord

Merknader

Serveren må annonsere støtte for byte-intervall; ellers feiler kallet raskt med PDFLIB_ERROR_NET_RANGE_UNSUPPORTED i stedet for å laste ned hele filen

Lukk det returnerte håndtaket med DACloseFile, som også frigjør den underliggende transportstrømmen

Samtidige utsatte lesinger deler forespørsler for samme blokk og slår sammen tilstøtende blokker i kø til kildelesinger begrenset til 16 MiB

Bruk GetLinearizedURLAccessPlan for å undersøke byte-intervall-layouten til side 1 uten å åpne dokumentet

Bruk DAGetRangeSourceCacheInfo, DASetRangeSourceCacheLimit og DAClearRangeSourceCache for å observere eller endre en Delphi direct-access-cache