THPDFXRefRecoveryStatus Type
Reports how the bounded cross-reference recovery pass over a damaged document turned out
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, so recovery never ran |
xrrsSucceeded |
Recovery completed and produced either a usable cross-reference table or rebuilt object offsets |
xrrsDisabled |
Recovery was skipped because the configured recovery mode is switched off |
xrrsScanLimitExceeded |
The source stream goes past XRefRecoveryMaxScanBytes or no scan budget has been configured |
xrrsObjectLimitExceeded |
XRefRecoveryMaxObjects is not greater than zero, or the recovery candidate limit was passed during the scan |
xrrsXRefLimitExceeded |
The cross-reference section candidate limit was passed during the scan |
xrrsFailed |
Recovery ran but could not rebuild a usable page tree, for instance on a non-seekable source stream |
Usage notes
- The status travels in the
Statusfield ofTHPDFXRefRecoveryInfoalong with the method used, the bytes scanned and the candidate counts - Any value other than
xrrsNotNeededmeans at least one attempt was made at the recovery pass