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 產生;加密前要停用則用零

傳回值

1The setting was accepted
0所選文件的狀態無法接受此設定;LastErrorCode 傳回 418

備註

請在 Encrypt、EncryptFile 或 EncryptFileEx 之前呼叫此函數

PDF MAC 要求加密強度 4(AES-256 revision 6)或強度 5(AES-GCM);其他強度以錯誤 418 失敗

產生時使用 32 位元組隨機 MAC 金鑰、HKDF-SHA-256 金鑰推導、AES-256 金鑰包裹、HMAC-SHA-256,以及 CMS AuthenticatedData 記錄

另請參閱

GetPDFMACStatus, ValidatePDFMAC, Encrypt