SetCryptFilterConfiguration

安全性、附件

描述

以原子方式選擇下一次加密操作時，哪些 PDF 物件類別要使用文件標準 crypt filter

Function TPDFlib.SetCryptFilterConfiguration(EncryptStrings, EncryptStreams, EncryptEmbeddedFiles: Integer): Integer;

Function DLSetCryptFilterConfiguration(InstanceID, EncryptStrings, EncryptStreams, EncryptEmbeddedFiles: Integer): Integer; Stdcall;

Function PDFlib::SetCryptFilterConfiguration(EncryptStrings As Long, EncryptStreams As Long, EncryptEmbeddedFiles As Long) As Long

EncryptStrings	1 為 /StrF 選擇標準 filter；0 選擇 Identity
EncryptStreams	1 透過 /StmF 為一般串流選擇標準 filter；0 選擇 Identity
EncryptEmbeddedFiles	1 透過 /EFF 為內嵌檔案串流選擇標準 filter；0 選擇 Identity

0	值不是零或一、三個目標全部停用、未選取文件，或加密已經開始
1	完整的目標設定已受理

預設為 1, 1, 1，即加密字串、一般串流與內嵌檔案

選擇性設定需要 AES-128、AES-256、AES-256 Acrobat X 或 AES-256-GCM，並一致套用到密碼、公開金鑰與指紋加密

既有的 SetEncryptEmbeddedFilesOnly 方法把 1 對應到 0, 0, 1、把 0 對應回 1, 1, 1

PDF.SetCryptFilterConfiguration(0, 1, 0);
PDF.Encrypt('owner-password', 'user-password', 2, Permissions);
PDF.SaveToFile('selective-encryption.pdf');