IOpcSignatureRelationshipReference interface
Represents a reference to a Relationships part that contains relationships that have been or will be signed.
When to implement
Never. Custom implementations of this interface are not supported.
Members
The IOpcSignatureRelationshipReference interface inherits from the IUnknown interface. IOpcSignatureRelationshipReference also has these types of members:
Methods
The IOpcSignatureRelationshipReference interface has these methods.
| Method | Description |
|---|---|
| GetDigestMethod |
Gets the digest method to use on relationship markup of the selected relationships. |
| GetDigestValue |
Gets the digest value calculated for the selected relationships when they are signed. |
| GetRelationshipSelectorEnumerator |
Gets an enumerator of IOpcRelationshipSelector interface pointers that represent the techniques used to select the subset of relationships in the referenced Relationships part. |
| GetRelationshipSigningOption |
Gets a value that describes whether all or a subset of relationships that are stored in the referenced Relationships part are selected. |
| GetSourceUri |
Gets the source URI of the relationships that are stored in the referenced Relationships part. |
| GetTransformMethod |
Gets the canonicalization method to use on the relationship markup of the selected relationships when they are signed. |
Remarks
To create an IOpcSignatureRelationshipReference interface pointer that represents a reference to a Relationships part, call the Create method. This reference will indicate whether all or a subset of the relationships in the Relationships part will be signed when the signature is generated.
To access an IOpcSignatureRelationshipReference interface pointer, call the IOpcSignatureRelationshipReferenceEnumerator::GetCurrent method.
Relationships that are not selected for signing can be removed, modified or added to the package without invalidating the signature. If a subset of relationships has been selected for signing and the subset is altered, the signature will be invalidated.
The interface provides methods to access information about the referenced Relationships part, the selected relationships that have been or will be signed, and the reference itself. When a signature is generated, this reference information is serialized in the XML markup of the signature (signature markup). In signature markup, the information is represented by a Reference element that has a URI attribute value that identifies a Relationships part.
Thread Safety
Packaging objects are not thread-safe.
For more information, see the Getting Started with the Packaging API.
Requirements
|
Minimum supported client | Windows 7 [desktop apps | Windows Store apps] |
|---|---|
|
Minimum supported server | Windows Server 2008 R2 [desktop apps | Windows Store apps] |
|
Header |
|
|
IDL |
|
See also
- Packaging Digital Signature Interfaces
- Overviews
- Digital Signatures Overview
- Getting Started with the Packaging API
- Packaging API Programming Guide
- Reference
- IOpcSignatureRelationshipReferenceEnumerator
- IOpcSignatureRelationshipReferenceSet
- OPC_CANONICALIZATION_METHOD
- OPC_RELATIONSHIPS_SIGNING_OPTION
- Core Packaging Interfaces
- Packaging Interfaces
- Packaging API Reference
- Packaging API Samples