IOpcDigitalSignature：：GetPackageObjectReference 方法 (msopc.h)

發行項
03/13/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