IOpcSigningOptions 接口 (msopc.h)

项目
08/25/2023

提供用于设置和访问生成签名所需的信息的方法。

继承

IOpcSigningOptions 接口继承自 IUnknown 接口。 IOpcSigningOptions 还具有以下类型的成员：

方法

IOpcSigningOptions 接口具有这些方法。


IOpcSigningOptions：：GetCertificateEmbeddingOption 获取一个值，该值指定要用于签名的证书包中的存储位置。
IOpcSigningOptions：：GetCertificateSet 获取 IOpcCertificateSet 接口指针。
IOpcSigningOptions：：GetCustomObjectSet 获取 IOpcSignatureCustomObjectSet 接口。
IOpcSigningOptions：：GetCustomReferenceSet 获取 IOpcSignatureReferenceSet 接口指针。
IOpcSigningOptions：：GetDefaultDigestMethod 获取用于计算要签名对象的摘要值的默认摘要方法。
IOpcSigningOptions：：GetSignatureId 从 Signature 元素获取 Id 属性的值。
IOpcSigningOptions：：GetSignatureMethod 获取用于计算和加密 SignedInfo 元素的哈希值的签名方法，该元素将序列化为签名的 SignatureValue 元素。
IOpcSigningOptions：：GetSignaturePartName 获取将存储签名标记的签名部件的部件名称。
IOpcSigningOptions：：GetSignaturePartReferenceSet 获取 IOpcSignaturePartReferenceSet 接口。
IOpcSigningOptions：：GetSignatureRelationshipReferenceSet 获取 IOpcSignatureRelationshipReferenceSet 接口指针。
IOpcSigningOptions：：GetTimeFormat 获取由 IOpcDigitalSignature：：GetSigningTime 方法检索的字符串的格式。
IOpcSigningOptions：：SetCertificateEmbeddingOption 设置用于签名的证书的存储位置。
IOpcSigningOptions：：SetDefaultDigestMethod 设置将用于计算要签名对象的摘要值的默认摘要方法。
IOpcSigningOptions：：SetSignatureId 设置 Signature 元素的 Id 属性的值。 (IOpcSigningOptions.SetSignatureId)
IOpcSigningOptions：：SetSignatureMethod 设置用于计算和加密 SignedInfo 元素的哈希值的签名方法，该哈希值将包含在签名的 SignatureValue 元素中。
IOpcSigningOptions：：SetSignaturePartName 设置将存储签名标记的签名部件的部件名称。
IOpcSigningOptions：：SetTimeFormat 设置由 IOpcDigitalSignature：：GetSigningTime 方法检索的字符串的格式。

注解

若要生成签名，请使用 signOptions 参数值设置为 IOpcSigningOptions 接口指针调用 IOpcDigitalSignatureManager：：Sign 方法。

若要创建 IOpcSigningOptions 接口指针，请调用 IOpcDigitalSignatureManager：：CreateSigningOptions 方法。

在生成签名之前，调用方必须为摘要方法和签名方法设置默认值。若要设置默认摘要方法，请调用 SetDefaultDigestMethod 方法。若要设置签名方法，请调用 SetSignatureMethod 方法。

若要获取 IOpcSignatureCustomObjectSet 接口指针，请调用 GetCustomObjectSet 方法。集中的接口指针表示特定于应用程序的 Object 元素。

若要获取 IOpcSignatureReferenceSet 接口指针，请调用 GetCustomReferenceSet 方法。集中的接口指针表示对生成签名时将签名的特定于应用程序的 Object 元素或其子元素的引用。

证书的默认位置为 OPC_CERTIFICATE_IN_CERTIFICATE_PART。若要更改此值，请调用 SetCertificateEmbeddingOption 方法。

签名时间字符串的默认格式为 OPC_SIGNATURE_TIME_FORMAT_MILLISECONDS。若要更改签名时间字符串的格式，请调用 SetTimeFormat 方法。

线程安全性

打包对象不是线程安全的。

有关详细信息，请参阅打包 API 的入门。

要求


最低受支持的客户端	Windows 7 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows Server 2008 R2 [桌面应用 \|UWP 应用]
目标平台	Windows
标头	msopc.h