IOpcDigitalSignature：：GetPackageObjectReference 方法 (msopc.h)

项目
02/29/2024

获取一个 IOpcSignatureReference 接口指针，该指针表示对已签名的特定于包 的 Object 元素的引用。

语法

HRESULT GetPackageObjectReference(
  [out, retval] IOpcSignatureReference **packageObjectReference
);

参数

[out, retval] packageObjectReference

一个 IOpcSignatureReference 接口指针，表示对已签名的包特定 Object 元素的引用。

返回值

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

返回代码	说明
S_OK	方法成功。
E_POINTER	packageObjectReference 参数为 NULL。

注解

packageObjectReference 参数中收到的 IOpcSignatureReference 接口指针表示 URI 属性值设置为“#idPackageObject”的 Reference 元素。此元素的 URI 属性值是特定于包的 Object 元素的 Id 属性值，前缀为井号 (“#”) 。

生成签名并将其序列化为签名标记时，对引用和引用的包特定的 Object 元素进行签名。以下标记显示结果签名标记中特定于包的 Reference 元素和包特定的 Object 元素。

<!-- Signature markup. -->
<Signature>
    <SignedInfo>
        [...]
        <!-- A reference to the package-specific <Object> that
        is, or will be, signed. -->
        <Reference URI="#idPackageObject">
             [...]
        </Reference>
    </SignedInfo>
    [...]
    <!-- The package-specific <Object> element. -->
    <Object Id="idPackageObject">
        <!-- This element contains the <Reference> elements that
        refer to parts and relationships in the package that are
        or will be signed. -->
        <Manifest>
            [...] 
        </Manifest>
    </Object>
</Signature>

线程安全性

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

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

要求

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