hpdf_document_compare_json_v1
使用不變的 ABI v1 操作記錄比較兩份借用的已載入文件
hpdf_status HPDF_CDECL hpdf_document_compare_json_v1(
hpdf_document handle_a, hpdf_document handle_b,
const hpdf_operation_v1 *operation);
宣告於 hotpdf_abi.h,由 HotPDFABI.dll 以 C 呼叫慣例匯出
兩個 handle 都必須有效且已載入;自我比較可以傳入同一 handle 兩次
操作要求 schemaVersion 為 1、type 為 compare 或 compare.contract、NULL input_io,以及可寫的 result_io;output_io 可選擇性接收 JSON、HTML 或審閱 PDF
檔案輸入與輸出鍵會被拒絕;兩個來源 context 在整個呼叫期間保持被參照,其取消 callback 各自獨立輪詢
回傳 0 表示有結果(包括明確不完整的泛用比較)、1 表示引數無效、2 表示 handle 無效、3 表示記錄不相容、4 表示取消、5 表示 I/O 失敗、6 表示 JSON 解析失敗、7 表示內部錯誤、8 表示預算失敗
呼叫端必須序列化每個 handle 上的操作,並在 handle 存續期間與活動呼叫中保留來源 callback;callback 發布失敗可能保留已接受的輸出位元組,而來源物件圖保持不變