SetSignatureFieldSeedValue
安全和签名
描述
创建或替换未签名签名字段的 /SV 种子值字典,并选择签名操作必须强制执行哪些约束
语法
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 表示过滤器,2 表示 SubFilter,4 表示种子值版本,8 表示原因,16 表示法律声明,32 表示吊销信息,64 表示摘要方法 |
| SubFilters | 以分号分隔的允许 SubFilter 名称,例如 ETSI.CAdES.detached 或 adbe.pkcs7.detached |
| DigestMethods | 以分号分隔的允许摘要名称:SHA1、SHA256、SHA384、SHA512、SHA3-256、SHA3-384 或 SHA3-512 |
| Reasons | 以分号分隔的允许签名原因;当必须使用原因标志时,空列表或 . 禁止自定义原因 |
| LegalAttestations | /LegalAttestation 种子值约束允许的法律证明名称,以分号分隔,默认为空,Delphi API 扩展未通过 DLL 或 ActiveX 层公开 |
返回值
| 1 | 已写入种子值字典 |
|---|---|
| 0 | 字段、标志或必填值列表无效 |
备注
该方法写入种子值版本 2 和过滤器 Adobe.PPKLite
此版本无法强制实施的必需约束会在编写字典时被拒绝,并在从现有 PDF 读取时采用故障关闭方式
ANSI DLL 变体为 DLSetSignatureFieldSeedValueA
另请参阅
AddSignatureFieldSeedCertificate, ClearSignatureFieldSeedValue, GetSignProcessSeedValueError