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 層不開放

傳回值

1seed 值字典已寫出
0欄位、旗標或必要值清單無效

備註

方法寫出 seed 值版本 2 與 filter Adobe.PPKLite本版無法執行的必要約束,在撰寫字典時就會被拒絕;從既有 PDF 讀到時則採保守失敗

The ANSI DLL variant is

DLSetSignatureFieldSeedValueA

另請參閱

AddSignatureFieldSeedCertificate, ClearSignatureFieldSeedValue, GetSignProcessSeedValueError