ReadRange

Documentonderdelen, variabele gegevens, documentbewerking

Beschrijving

Leest een bytebereik via een TCallbackByteRangeSource in een door de aanroeper aangeleverde buffer door de aanroep door te sturen naar de leescallback

Syntaxis

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

Syntaxis

StartOffset0-based offset van de eerste te lezen byte
CountAantal opgevraagde bytes
BufferBuffer van de aanroeper die de opgevraagde bytes ontvangt

Opmerkingen

Het verzoek wordt geweigerd wanneer geen leescallback is toegewezen, Buffer Nil is, Count nul of negatief is, StartOffset negatief is of StartOffset de totale grootte bereikt

Een verzoek dat voorbij de totale grootte reikt wordt begrensd op de resterende bytes in plaats van geweigerd

Een callbackresultaat onder nul wordt als nul behandeld, en een resultaat boven de begrensd aantal wordt teruggebracht tot dat aantal

Het foutbericht dat voor een geweigerd verzoek of een callback-exception is vastgelegd, is beschikbaar via GetLastError

Retourwaarden

0Het verzoek was ongeldig, de leescallback veroorzaakte een exception of de callback heeft geen bytes overgedragen; GetLastError beschrijft de fout wanneer er een melding is vastgelegd
PositiveAantal daadwerkelijk gelezen bytes, nooit meer dan het begrensde verzoek

Zie ook

GetLastError, IsRangeAvailable, GetTotalSize, GetRangeSupported, LoadFromRangeSource