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
StartOffset | 0-based offset van de eerste te lezen byte |
|---|---|
Count | Aantal opgevraagde bytes |
Buffer | Buffer 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
0 | Het 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 |
|---|---|
| Positive | Aantal daadwerkelijk gelezen bytes, nooit meer dan het begrensde verzoek |
Zie ook
GetLastError, IsRangeAvailable, GetTotalSize, GetRangeSupported, LoadFromRangeSource