THPDFHeadlessDocument.SaveAnnotationRemovalsToFile 方法

function SaveAnnotationRemovalsToFile(const FileName: string;
  const Identities: array of THPDFHeadlessAnnotationIdentity;
  const Options: THPDFHeadlessAnnotationRemovalOptions): Integer;

從目前已載入來源準備頁面註解移除，並把單獨的 PDF 原子發佈到 FileName

Identities 按有效的從零開始頁面索引與精確解碼的 Unicode NM 值選擇註解；Options 提供正的資源限制與選用的共用取消

回傳值對每個被移除的註解計一次，包括 popup 與回覆依賴；可以超過請求識別的數量

空請求或有效但未相符的識別回傳零並發佈精確的目前來源位元組；重複識別、有歧義的選中名稱與共用註解擁有者會失敗

移除擁有者會傳遞地移除依賴的 popup 與回覆，環處理有界；只移除 popup 會清除被保留擁有者的 Popup 連結

選中或依賴的 Widget 會拋出 hdFieldTypeUnsupported，因為欄位樹刪除是單獨的交易

狀態與發佈

成功與失敗之後已載入文件都保持不變；重新載入發佈的 PDF 以採用變更後的修訂

有變更的輸出是保留原檔前綴的增量修訂；零變更產生精確副本，此操作不安全抹除舊修訂

輸出路徑不得是已載入來源的別名；配置失敗、無效輸入、政策拒絕、預算耗盡與取消都會保留現有目的地

政策與診斷

實際變更要求加密文件的註解權限與經驗證的簽章文件政策准入；認證 P1/P2 拒絕變更，獲准的 P3 變更保留原始簽章位元組範圍

無效識別與畸形歸屬回報 hdInvalidDocument；資源耗盡回報 hdLimitExceeded；Widget 選擇回報 hdFieldTypeUnsupported

安全、簽章與取消失敗保留其既有原生診斷契約；透過文件的簽章政策選項設定信任與時間戳記要求