IOpcSignatureReference-Schnittstelle (msopc.h)

Artikel
08/25/2023

Stellt einen Verweis auf xml-Markup dar, das signiert wurde oder wird. Dieses xml-Markup, auf das verwiesen wird, wird im Signaturmarkup serialisiert, wenn eine Signatur generiert wird.

Vererbung

Die IOpcSignatureReference-Schnittstelle erbt von der IUnknown-Schnittstelle . IOpcSignatureReference verfügt auch über folgende Membertypen:

Methoden

Die IOpcSignatureReference-Schnittstelle verfügt über diese Methoden.


IOpcSignatureReference::GetDigestMethod Ruft die Digestmethode ab, die für das XML-Element verwendet werden soll, auf das verwiesen wird, wenn das Element signiert ist.
IOpcSignatureReference::GetDigestValue Ruft den Digestwert ab, der für das XML-Element berechnet wird, auf das verwiesen wird, wenn das Element signiert ist.
IOpcSignatureReference::GetId Ruft den Bezeichner für den Verweis ab.
IOpcSignatureReference::GetTransformMethod Ruft die Kanonisierungsmethode ab, die für das XML-Element verwendet werden soll, auf das verwiesen wird, wenn das Element signiert ist.
IOpcSignatureReference::GetType Ruft eine Zeichenfolge ab, die den Typ des XML-Elements angibt, auf das verwiesen wird.
IOpcSignatureReference::GetUri Ruft den URI des XML-Elements ab, auf das verwiesen wird.

Hinweise

Um einen IOpcSignatureReference-Schnittstellenzeiger zu erstellen, rufen Sie die IOpcSignatureReferenceSet::Create-Methode auf. IOpcSignatureReferenceSet::Create erstellt nicht den Verweis auf das paketspezifische Object-Element . dieser Verweis wird automatisch erstellt, wenn die Signatur generiert wird.

Um auf einen IOpcSignatureReference-Schnittstellenzeiger zuzugreifen, rufen Sie die IOpcSignatureReferenceEnumerator::GetCurrent-Methode auf. IOpcSignatureReferenceEnumerator::GetCurrent greift nicht auf den Verweis auf das paketspezifische Object-Element zu. rufen Sie die IOpcDigitalSignature::GetPackageObjectReference-Methode auf, um auf diesen Verweis zuzugreifen.

Die Schnittstelle stellt Methoden zum Zugreifen auf Informationen über den Verweis selbst und das XML-Element bereit, auf das verwiesen wird. Das Element, auf das verwiesen wird, kann das paketspezifische Object-Element , ein anwendungsspezifisches Object-Element oder ein untergeordnetes Element eines anwendungsspezifischen Objekts sein.

Wenn eine Signatur generiert wird, werden diese Verweisinformationen im XML-Markup der Signatur (Signaturmarkup) serialisiert. Im Signaturmarkup werden die Informationen durch ein Reference-Element dargestellt, dessen URI-Attributwert auf "#" festgelegt ist, gefolgt vom Id-Attributwert des Elements, auf das verwiesen wird. Wenn beispielsweise das Id-Attribut des Elements, auf das verwiesen wird, "Application" lautet, wird das URI-Attribut des Reference-Elements auf "#Application" festgelegt, wie im folgenden Markup gezeigt.

Das folgende Signaturmarkup zeigt einen serialisierten Verweis auf ein signiertes, anwendungsspezifisches Object-Element .

<Signature Id="SignatureId" xmlns="http://www.w3.org/2000/09/xmldsig#">
    <SignedInfo>
        [...]
        <Reference URI="#idPackageObject" ...>
            [...]
        </Reference>
        <!-- This reference indicates that the application-specific
        Object element was signed when the signature was generated.-->
        <Reference URI="#Application" ...>
            [...]
        </Reference>
    </SignedInfo>
    [...]
    <Object Id="idPackageObject" ...>
        [...]
    </Object>
    <!-- This application-specific <Object> element was signed when the
    signature was generated. -->
    <Object Id="Application">
        [...]
    </Object>
</Signature>

Das folgende Signaturmarkup zeigt einen serialisierten Verweis auf ein signiertes, untergeordnetes Element eines anwendungsspezifischen Object-Elements .

Hinweis Für die Signatur kann auf mehr als ein untergeordnetes Element eines anwendungsspezifischen Objekts verwiesen werden.

<Signature Id="SignatureId" xmlns="http://www.w3.org/2000/09/xmldsig#">
    <SignedInfo>
        [...]
        <Reference URI="#idPackageObject" ...>
            [...]
        </Reference>
        <!-- This reference indicates that MyElement in the application
        -specific Object element was signed when the signature was
        generated. -->
        <Reference URI="#MyElementId" ...>
            [...]
        </Reference>
    </SignedInfo>
    [...]
    <Object Id="idPackageObject" ...>
        [...]
    </Object>
    <Object Id="Application">
        [...]
            <!-- This element is signed. -->
            <MyElement Id="MyElementId">
                [...]
            </MyElement>
        [...]
    </Object>
</Signature>

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	msopc.h