THPDFHeadlessDocument.SaveAnnotationRemovalsToFile 메서드

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

현재 로드된 소스에서 페이지 주석 제거를 준비하고 별개의 PDF를 FileName으로 원자적으로 게시합니다

Identities는 유효한 0-기반 페이지 인덱스와 정확히 디코딩된 Unicode NM 값으로 주석을 고릅니다. Options는 양수 자원 한계와 선택적 공유 취소를 공급합니다

반환 값은 팝업과 답글 의존성을 포함해 제거된 모든 주석을 한 번씩 셉니다. 요청 identity 수를 넘을 수 있습니다

빈 요청이나 일치하지 않는 유효 identity는 0을 반환하고 현재 소스 바이트를 정확히 게시합니다. 중복 identity, 모호한 선택 이름, 공유 주석 소유자는 실패합니다

소유자를 제거하면 의존 팝업과 답글이 전이적으로 제거되며 사이클 처리가 유한합니다. 팝업만 제거하면 유지된 소유자의 Popup 링크를 지웁니다

선택되거나 의존된 Widget은 hdFieldTypeUnsupported를 일으킵니다. 필드 트리 삭제는 별개의 트랜잭션이기 때문입니다

상태와 게시

로드된 문서는 성공과 실패 모두 뒤에 변하지 않습니다. 바뀐 리비전을 적용하려면 게시된 PDF를 다시 로드하세요

바뀐 출력은 원본 파일 접두부를 유지하는 증분 리비전입니다. 변경 0건은 정확한 복사본을 만들고, 이 연산은 오래된 리비전을 보안 삭제하지 않습니다

출력 경로는 로드된 소스를 별칭해서는 안 됩니다. 할당 실패, 무효 입력, 정책 거부, 예산 소진, 취소는 기존 목적지를 보존합니다

정책과 진단

실제 변경에는 암호화 문서 주석 권한과 인증된 서명 문서 정책 인정이 필요합니다. certification P1/P2는 변경을 거부하고, 인정된 P3 변경은 원본 서명 바이트 범위를 유지합니다

무효 identity와 malformed 소유는 hdInvalidDocument를, 자원 고갈은 hdLimitExceeded를, Widget 선택은 hdFieldTypeUnsupported를 보고합니다

보안, 시그니처, 취소 실패는 기존 네이티브 진단 계약을 유지합니다. 신뢰와 타임스탬프 요구는 문서의 시그니처 정책 옵션으로 구성하세요

THPDFHeadlessAnnotationIdentity, THPDFHeadlessAnnotationRemovalOptions, 네이티브 주석 제거를 참고하세요