ReadRange

Dokumentdeler, variable data, dokumentredigering

Beskrivelse

Leser et byteområde gjennom en TCallbackByteRangeSource inn i en buffer levert av kalleren ved å videresende til lesetilbakeringingen

Syntaks

Function TCallbackByteRangeSource.ReadRange(StartOffset: Int64;
  Count: LongInt; Buffer: PAnsiChar): LongInt;

Parametere

StartOffsetNullbasert forskyvning til den første byten som skal leses
CountAntall byte som er forespurt
BufferBuffer hos kalleren som mottar de forespurte bytene

Merknader

Forespørselen avvises når ingen lese-callback er tildelt, Buffer er Nil, Count er null eller negativ, StartOffset er negativ eller StartOffset når total størrelse

En forespørsel som strekker seg forbi total størrelse begrenses til de gjenværende bytene i stedet for å avvises

Et callback-resultat under null behandles som null, og et resultat over det begrensede antallet reduseres til antallet

Feilmeldingen registrert for en avvist forespørsel eller et callback-unntak er tilgjengelig gjennom GetLastError

Returverdier

0Forespørselen var ugyldig, lesetilbakeringingen ga et unntak, eller tilbakeringingen overførte ingen byte; GetLastError beskriver feilen når en melding ble registrert
PositiveAntall byte som faktisk ble lest, aldri mer enn den begrensede forespørselen

Se også

GetLastError, IsRangeAvailable, GetTotalSize, GetRangeSupported, LoadFromRangeSource