SetCryptFilterConfiguration

安全、附件

描述

原子性地选择在下一次加密操作期间哪些 PDF 对象类使用文档标准加密过滤器

语法

Delphi

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

DLL

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

ActiveX

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

参数

EncryptStrings1 为 /StrF 选择标准过滤器;0 选择 Identity
EncryptStreams1 通过 /StmF 为普通流选择标准过滤器;0 选择 Identity
EncryptEmbeddedFiles1 通过 /EFF 选择嵌入文件流的标准过滤器;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');

另请参阅

GetEncryptStrings、GetEncryptStreams、GetEncryptEmbeddedFiles、Encrypt、EncryptPublicKey