HPDFRenderHeadlessPagePNGFile

function HPDFRenderHeadlessPagePNGFile(const Access: THPDFHeadlessRenderAccess;
  const FileName: string; const Options: THPDFHeadlessRenderOptions):
  THPDFHeadlessRenderResult;

声明于 HPDFHeadlessCairoDevice；渲染一个借用的页面并把其 PNG 原子发布到 FileName

父目录必须已存在；调用成功时替换既有目标文件并返回其渲染计数器

必须提供 Access.RequireOutputPath，它在暂存前和发布前检查源路径与物理文件身份；文档的 GetRenderAccess 提供该回调

源路径与源硬链接别名会被拒绝；借用的文档在调用期间保持已加载且不变

该辅助函数在目标文件旁独占创建自有暂存文件，写入完成的 PNG，刷盘，再次检查取消，然后执行原子改名或替换

预算、渲染、取消和暂存失败都会保留既有目标文件并删除自有未发布的暂存文件

Windows 上最多执行八次原子替换，只对错误 5、32 和 33 重试，等待为 1、2、4、8、16、16 和 16 毫秒；其他错误立即失败

每次替换尝试之前以及每次等待前后都检查取消；不存在删除目标文件或非原子拷贝的回退

Windows 替换失败时抛出携带捕获的最终 Windows 错误码的 EHPDFHeadlessRenderError；取消时保留渲染器的取消诊断

输出到流请使用 HPDFRenderHeadlessPagePNG；格式与资源边界参见渲染器指南