DAGetXRefDiagnostics

Direct access functionality, Diagnostics

Description

Returns the cross-reference and trailer JSON report for a direct-access document handle

Function TPDFlib.DAGetXRefDiagnostics(FileHandle: Integer; Out Report: WideString): Integer;

FileHandle	A valid direct-access document handle
Report	Receives the same structural fields as `GetXRefDiagnostics`, including the configured load policy, compatibility decisions and any Direct Access raw reconstruction

0	The handle is invalid, `Report` is empty and `LastErrorCode` is set to 401
1	The report was returned

The report distinguishes traditional tables, cross-reference streams, hybrid-reference files and revision chains that switch representation

Each section retains its declared offset, effective physical offset, trailer boundary, link source, compatibility flags and parse result

PDF_XREF_LOAD_RECOVERY, Direct Access can report recovered top-level objects, compressed object-stream members and synthesised trailer data