THPDFXRefRecoveryStatus Type
Reports the outcome of the bounded cross-reference recovery pass over a damaged document
Declaration
THPDFXRefRecoveryStatus= (xrrsNotNeeded, xrrsSucceeded, xrrsDisabled,
xrrsScanLimitExceeded, xrrsObjectLimitExceeded,
xrrsXRefLimitExceeded, xrrsFailed);Unit
HPDFDoc
Values
| Value | Meaning |
|---|---|
xrrsNotNeeded |
The normal spec-first load produced a usable page tree; recovery never ran |
xrrsSucceeded |
Recovery completed and produced a usable cross-reference table or rebuilt object offsets |
xrrsDisabled |
Recovery was skipped because the configured recovery mode is disabled |
xrrsScanLimitExceeded |
The source stream exceeds XRefRecoveryMaxScanBytes or no scan budget is configured |
xrrsObjectLimitExceeded |
XRefRecoveryMaxObjects is not greater than zero or the recovery candidate limit was exceeded during the scan |
xrrsXRefLimitExceeded |
The cross-reference section candidate limit was exceeded during the scan |
xrrsFailed |
Recovery ran but could not rebuild a usable page tree, for example on a non-seekable source stream |
Usage notes
- The status travels in the
Statusfield ofTHPDFXRefRecoveryInfotogether with the method used, bytes scanned and candidate counts - Any value other than
xrrsNotNeededmeans the recovery pass was attempted at least once