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