IOpcSignatureCustomObject interface (msopc.h)

Represents an application-specific Object element that has been or will be signed.

Inheritance

The IOpcSignatureCustomObject interface inherits from the IUnknown interface. IOpcSignatureCustomObject also has these types of members:

Methods

The IOpcSignatureCustomObject interface has these methods.

 
IOpcSignatureCustomObject::GetXml

Gets the XML markup of an application-specific Object element.

Remarks

An IOpcSignatureCustomObject interface pointer provides access to the XML markup of the Object element it represents. To access the XML markup of the Object element, call the IOpcSignatureCustomObject::GetXml method.

Serialized application-specific Object elements in signature markup can be added, removed, or modified by replacing the signature markup.

To replace signature markup, call the IOpcDigitalSignatureManager::ReplaceSignatureXml method. The caller must ensure that addition, deletion, or modification of application-specific Object elements does not break the signature.

To sign an application-specific Object element or a child of the element, create a reference to the element to be signed. Create the reference by calling the IOpcSignatureReferenceSet::Create method with the referenceUri parameter value set to "#" followed by the Id attribute value of the referenced element. For example, if the Id attribute of the referenced element is "Application", set referenceUri to "#Application".

To create an IOpcSignatureCustomObject interface pointer, call the IOpcSignatureCustomObjectSet::Create method.

To access an IOpcSignatureCustomObject interface pointer, call the IOpcSignatureCustomObjectEnumerator::GetCurrent method.

When a signature is generated, the markup of application-specific Object element is included in the signature markup.

Application-specific Object elements are not required for package signatures.

Thread Safety

Packaging objects are not thread-safe.

For more information, see the Getting Started with the Packaging API.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header msopc.h

See also

Core Packaging Interfaces

Digital Signatures Overview

Getting Started with the Packaging API

IOpcSignatureCustomObjectEnumerator

IOpcSignatureCustomObjectSet

IOpcSignatureReference

IOpcSignatureReferenceSet

Overviews

Packaging API Programming Guide

Packaging API Reference

Packaging API Samples

Packaging Digital Signature Interfaces

Packaging Interfaces

Reference