ReadRange

أجزاء المستند، البيانات المتغيرة، تحرير المستندات

الوصف

تقرأ مدى بايتات عبر TCallbackByteRangeSource إلى مخزن مؤقت يوفره المستدعي بإحالة المهمة إلى دالة استدعاء القراءة

الصيغة

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

المعاملات

StartOffsetإزاحة أول بايت يُقرأ ذات الأساس صفر
Countعدد البايتات المطلوبة
Bufferالمخزن المؤقت للمستدعي الذي يستقبل البايتات المطلوبة

ملاحظات

يُرفض الطلب عندما لا يوجد رد نداء قراءة معيّن، أو يكون Buffer يساوي Nil، أو يكون Count صفرًا أو سالبًا، أو تكون StartOffset سالبة أو تبلغ StartOffset الحجم الكلي

الطلب الممتد بعد الحجم الكلي يقيَّد إلى البايتات المتبقية بدل رفضه

نتيجة رد النداء دون الصفر تعامل صفرًا، والنتيجة فوق العدد المقيَّد تخفض إلى العدد

GetLastError

قيم الإرجاع

0كان الطلب غير صالح أو رفعت دالة استدعاء القراءة استثناءً أو لم تنقل دالة الاستدعاء أي بايتات؛ وتصف GetLastError الإخفاق عندما تكون هناك رسالة مسجلة
Positiveعدد البايتات المقروءة فعلًا، ولا يتجاوز الطلب المقيَّد أبدًا

انظر أيضًا

GetLastError, IsRangeAvailable, GetTotalSize, GetRangeSupported, LoadFromRangeSource