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 | The 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 記錄