ReadRange
Dokumentdelar, variabel data, dokumentredigering
Beskrivning
Läser ett byteintervall via en TCallbackByteRangeSource till en anroparlevererad buffert genom att vidarebefordra till läsåteranropet
Syntax
Function TCallbackByteRangeSource.ReadRange(StartOffset: Int64;
Count: LongInt; Buffer: PAnsiChar): LongInt;Parametrar
StartOffset | Nollbaserad offset för första byten som ska läsas |
|---|---|
Count | Antal begärda byte |
Buffer | Anroparbuffert som tar emot de begärda bytena |
Anmärkningar
Begäran avvisas när inget läsåteranrop är tilldelat, Buffer är Nil, Count är noll eller negativ, StartOffset är negativ eller StartOffset når den totala storleken
En begäran som sträcker sig förbi den totala storleken begränsas till de återstående bytena i stället för att avvisas
Ett återanropsresultat under noll behandlas som noll, och ett resultat över det begränsade antalet minskas till antalet
Felmeddelandet som registrerats för en avvisad begäran eller ett återanropsundantag är tillgängligt viaGetLastError
Returvärden
0 | Begäran var ogiltig, läsåteranropet utlöste ett undantag eller återanropet överförde inga byte; GetLastError beskriver felet när ett meddelande registrerades |
|---|---|
| Positive | Antal byte som faktiskt lästs, aldrig mer än den begränsade begäran |
Se även
GetLastError, IsRangeAvailable, GetTotalSize, GetRangeSupported, LoadFromRangeSource