iOpcSignaturePartReferenceSet：：Create 方法 (msopc.h)

项目
02/29/2024

创建表示对要签名的部件的引用的 IOpcSignaturePartReference 接口指针，并将新接口添加到集。

语法

HRESULT Create(
  [in]          IOpcPartUri                 *partUri,
  [in]          LPCWSTR                     digestMethod,
  [in]          OPC_CANONICALIZATION_METHOD transformMethod,
  [out, retval] IOpcSignaturePartReference  **partReference
);

参数

[in] partUri

一个 IOpcPartUri ，表示要引用的部件的部件名称。

[in] digestMethod

要用于要引用的部件的部件内容的摘要方法。若要使用默认摘要方法，请将 NULL 传递给此参数。

重要在调用 IOpcDigitalSignatureManager：：Sign 之前，必须通过调用 IOpcSigningOptions：：SetDefaultDigestMethod 方法来设置默认摘要方法。

[in] transformMethod

用于要引用的部件的部件内容的规范化方法。

[out, retval] partReference

一个新的 IOpcSignaturePartReference 接口指针，表示对要签名的部件的引用。

如果不需要指向新接口的指针，此参数可以为 NULL 。

返回值

该方法返回 HRESULT。可能的值包括（但并不限于）下表中的项。

返回代码	说明
S_OK	方法成功。
E_INVALIDARG	transformMethod 参数中传递的值不是有效的OPC_CANONICALIZATION_METHOD枚举值。
E_POINTER	partUri 参数为 NULL。

注解

IOpcSignaturePartReference 接口指针只能引用可由 IOpcSignaturePartReference 接口表示的部分。通过指向 IOpcSignatureRelationshipReference 接口的指针引用关系部件进行签名。若要创建 IOpcSignatureRelationshipReference 接口指针，请调用 IOpcSignatureRelationshipReferenceSet：：Create 方法。

创建 IOpcSignaturePartReference 接口指针并将其添加到集时，保存包时将保存它所表示的引用。

线程安全性

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

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

要求

要求	值
最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
目标平台	Windows
标头	msopc.h