SetRecoveryMode

Document loading, recovery, security

Description

Selects the depth of raw object reconstruction used for later selected-document loads when PDF_XREF_LOAD_RECOVERY permits fallback

Syntax

Delphi

Function TPDFlib.SetRecoveryMode(Mode: Integer): Integer;

Parameters

Mode	`PDF_RECOVERY_STRICT` rejects damaged cross-reference data, `PDF_RECOVERY_REPAIR` rebuilds top-level objects only when a usable trailer survives, and `PDF_RECOVERY_BEST_EFFORT` may also recover object-stream members and synthesize a missing trailer

Return values

1	The mode was accepted
0	The mode was invalid and the previous setting was preserved

Remarks

Call this method before LoadFromFile, LoadFromStream, or LoadFromString

The default is PDF_RECOVERY_BEST_EFFORT for compatibility with earlier releases

This setting does not enable fallback when SetXRefLoadPolicy selects strict or compatible loading; Direct Access recovery always includes compressed-member recovery and trailer synthesis