السجل THPDFCABIOperationV1

موصف C ABI مسنود بالإصدارات لعملية مستند JSON واحدة بـ IO اعتمادًا على callback

THPDFCABIOperationV1 = record
  StructSize: UInt32;
  ABIVersion: UInt32;
  Flags: UInt64;
  JSON: PAnsiChar;
  JSONLength: NativeUInt;
  InputIO: PHPDFCABIIOV1;
  OutputIO: PHPDFCABIIOV1;
  ResultIO: PHPDFCABIIOV1;
end;

The unit is HPDFCAPI; StructSize and ABIVersion must match the sizes and versions reported by hpdf_abi_operation_v1_size and hpdf_abi_version or the call is rejected

JSON with JSONLength carries the UTF-8 operation object accepted by the same engine as الطريقة THPDFJobProcessor.ExecuteLoadedOperation

The three IO records are borrowed callback bundles: InputIO supplies source bytes, OutputIO receives binary results, and ResultIO receives the JSON result document

لعمليات تنفيذ JSON والمقارنة بمقبضتين، callback الكتابة الفاشلة لا تستدعى مجددًا لنشر نتيجة خطأ عبر ثنائية الكاتب وبيانات المستخدم نفسها، بما يشمل عندما تتقاسم OutputIO وResultIO تلك الثنائية؛ وبايتات المرشح الجزئية التي تلقاها المستدعي سلفًا تبقى مسؤوليته

قيم حالة الكتابة خارج مدى الحالة غير الصفرية المعرّف وعدادات بايتات ناجحة صفرية أو زائدة تصير HPDF_STATUS_IO_ERROR؛ وتخطيط سجل V1 وسلوك الكتابة الجزئية الناجحة يبقيان غير متغيرين

The struct is passed by pointer to hpdf_document_execute_json_v1 and hpdf_document_compare_json_v1, and extended only by appending fields behind a new ABI version

عمليات المستند عبر JSON وC ABI