SetPDFMACEnabled

安全和签名

描述

为所选文档和同一库实例上后续文件加密操作启用或禁用独立 PDF MAC 完整性令牌

该令牌对完整加密 PDF 进行身份验证(自身十六进制值除外),并在加载受保护文档时自动验证

语法

Delphi

Function TPDFlib.SetPDFMACEnabled(Enabled: Integer): Integer;

ActiveX

Function PDFlib::SetPDFMACEnabled(Enabled As Long) As Long

DLL

int DLSetPDFMACEnabled(int InstanceID, int Enabled);

参数

Enabled使用非零值在加密前启用 PDF MAC 生成,或使用零禁用它

返回值

1已接受该设置
0所选文档状态无法接受此设置;LastErrorCode 返回 418

备注

在调用 Encrypt、EncryptFile 或 EncryptFileEx 前调用此函数

PDF MAC 对 AES-256 修订版 6 要求加密强度 4,对 AES-GCM 要求强度 5,其他强度会出现错误 418

生成过程使用 32 字节随机 MAC 密钥、HKDF-SHA-256 密钥派生、AES-256 密钥封装、HMAC-SHA-256 和 CMS AuthenticatedData 令牌

另请参阅

GetPDFMACStatus,ValidatePDFMAC,Encrypt