IOpcDigitalSignature::GetPackageObjectReference-Methode (msopc.h)

Artikel
02/29/2024

Ruft einen IOpcSignatureReference-Schnittstellenzeiger ab, der den Verweis auf das paketspezifische Object-Element darstellt, das signiert wurde.

Syntax

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

Parameter

[out, retval] packageObjectReference

Ein IOpcSignatureReference-Schnittstellenzeiger , der den Verweis auf das paketspezifische Object-Element darstellt, das signiert wurde.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	Der packageObjectReference-Parameter ist NULL.

Hinweise

Der IOpcSignatureReference-Schnittstellenzeiger , der im parameter packageObjectReference empfangen wird, stellt das Reference-Element dar, dessen URI-Attributwert auf "#idPackageObject" festgelegt ist. Der URI-Attributwert dieses Elements ist der Id-Attributwert des paketspezifischen Object-Elements , dem ein Pfundzeichen ("#") vorangestellt ist.

Wenn die Signatur als Signaturmarkup generiert und serialisiert wird, werden der Verweis und das paketspezifische Object-Element signiert. Das folgende Markup zeigt das paketspezifische Reference-Element und das paketspezifische Object-Element im resultierenden Signaturmarkup.

<!-- 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>

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie im Erste Schritte mit der Verpackungs-API.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msopc.h