SetSignatureFieldSeedValue
安全與簽章
描述
為未簽署的簽章欄位建立或取代 /SV seed 值字典,並選擇簽署操作必須執行哪些約束
語法
Delphi
Function TPDFlib.SetSignatureFieldSeedValue(Index, Flags: Integer; Const SubFilters, DigestMethods, Reasons: WideString; Const LegalAttestations: WideString= ''): Integer;
ActiveX
Function PDFlib::SetSignatureFieldSeedValue(Index As Long, Flags As Long, SubFilters As String, DigestMethods As String, Reasons As String) As Long
DLL
int DLSetSignatureFieldSeedValue(int InstanceID, int Index, int Flags, const wchar_t* SubFilters, const wchar_t* DigestMethods, const wchar_t* Reasons);
參數
| Index | 以 1 起算的表單欄位索引,指向未簽署的簽章欄位 |
|---|---|
| Flags | 選取必要限制的位元遮罩:1 filter、2 SubFilter、4 seed-value 版本、8 原因、16 法律證明、32 撤銷資訊,以及 64 摘要方法 |
| SubFilters | 以分號分隔的允許 SubFilter 名稱,例如 ETSI.CAdES.detached 或 adbe.pkcs7.detached |
| DigestMethods | 以分號分隔的允許摘要名稱:SHA1、SHA256、SHA384、SHA512、SHA3-256、SHA3-384 或 SHA3-512 |
| Reasons | 以分號分隔的允許簽署原因;reason 旗標為必要時,空清單或 . 表示禁止自訂原因 |
| LegalAttestations | /LegalAttestation seed 值約束的允許法律聲明名稱,以分號分隔;預設為空。僅 Delphi API 提供,DLL 與 ActiveX 層不開放 |
傳回值
| 1 | seed 值字典已寫出 |
|---|---|
| 0 | 欄位、旗標或必要值清單無效 |
備註
方法寫出 seed 值版本 2 與 filter Adobe.PPKLite本版無法執行的必要約束,在撰寫字典時就會被拒絕;從既有 PDF 讀到時則採保守失敗
The ANSI DLL variant is
DLSetSignatureFieldSeedValueA
另請參閱
AddSignatureFieldSeedCertificate, ClearSignatureFieldSeedValue, GetSignProcessSeedValueError