CheckFileComplianceA

合规性、文档检查

描述

末尾的 A 表示 ANSI（char）DLL 入口点，ActiveX/COM 接口仅公开 Unicode 形式。其行为与 CheckFileCompliance 相同，字符串参数会按照当前的 SetAnsiMode 代码页进行解释

读取外部 PDF 文件并根据选定的 ISO 合规标准进行验证。返回值为零（文件完全通过选定测试），或为非零 StringListID 句柄，其中列出检测到的每项问题。列表中的每项均由短代码、冒号和便于阅读的消息组成，代码格式与 GetPDFUADiagnostics 完全相同。使用 GetStringListCount 和 GetStringListItem 枚举结果

PDF/A 测试覆盖全部六种符合性模式（PDF/A-1a、PDF/A-1b、PDF/A-2a、PDF/A-2b、PDF/A-3a、PDF/A-3b），并读取 pdfaid:part/pdfaid:conformance XMP 条目以决定应用哪套规则

PDF/UA-1 测试（在 v3.56.0 中添加）会根据 ISO 14289-1 检查外部 PDF，并在 10xxx 范围内生成诊断代码，使其在视觉上与 PDF/A 00xxx 代码保持区分

语法

Delphi

Function DLCheckFileComplianceA(InstanceID: Integer; InputFileName, Password: PAnsiChar; ComplianceTest, Options: Integer): Integer;

DLL

int DLCheckFileComplianceA(int InstanceID, const char * InputFileName, const char * Password, int ComplianceTest, int Options);

参数

返回值

PDF/A 问题代码（ComplianceTest = 1）

PDF/UA-1 问题代码（ComplianceTest = 2）

备注

PDF/A 测试旨在交付前快速自检。它会捕获可直接取消文件资格的文档级问题（错误 PDF 版本、缺失 OutputIntent、A 级缺失结构树、加密、PDF/A-1 中的图层）。它不会遍历每个内容流运算符，也不会验证每个绘制对象的字体嵌入或颜色空间引用 鈥?这些验证需要专用 PDF/A 验证器（如 veraPDF）。将此函数作为第一线检查和构建管线的回归门。需要库将问题列表格式化为可重用文本报告时，使用 CreatePreflightReport 或 SavePreflightReport。需要文本、JSON、HTML 或 CSV 报告输出时，使用 CreatePreflightReportEx 或 SavePreflightReportEx，或参阅 Preflight Reports 了解完整报告工作流

配套 API GetPDFUADiagnostics 会对当前正在构建的内存中文档执行类似的 PDF/UA-1（ISO 14289-1）检查，而非检查外部文件

使用此库生成 PDF/A 输出时，请在添加任何内容前调用 SetPDFAMode，SetPDFAMode 内的生成端防护会阻止所选部分禁止的操作，因此以该方式构建的文档通常会自动通过 CheckFileCompliance

示例

// Validate a delivered PDF/A file and print all issues
var
  Issues, Count, I: Integer;
begin
  Issues := PDF.CheckFileCompliance('archive.pdf', '', 1, 0);
  if Issues = 0 then
    WriteLn('archive.pdf: PDF/A conformant')
  else
  begin
    Count := PDF.GetStringListCount(Issues);
    WriteLn('archive.pdf: ', Count, ' PDF/A issue(s) detected:');
    for I := 1 to Count do
      WriteLn('  ', PDF.GetStringListItem(Issues, I));
  end;
end;

// Fast pass/fail gate in a CI pipeline — stop on the first issue
var
  Failed: Boolean;
begin
  Failed := PDF.CheckFileCompliance('build/output.pdf', '', 1, 1) <> 0;
  if Failed then
    Halt(1);
end;

另请参阅

预检报告、CreatePreflightReport、CreatePreflightReportEx、SavePreflightReport、SavePreflightReportEx、ComparePreflightReports、SetPDFAMode、GetPDFUADiagnostics、GetStringListCount、GetStringListItem、SetPDFUAMode