IOpcSignatureCustomObject interface

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

When to implement

Never. Custom implementations of this interface are not supported.

Members

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

Methods

The IOpcSignatureCustomObject interface has these methods.

MethodDescription
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

Minimum supported client

Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 R2 [desktop apps | Windows Store apps]

Header

Msopc.h

IDL

Msopc.idl

See also

Packaging Digital Signature Interfaces
Overviews
Digital Signatures Overview
Getting Started with the Packaging API
Packaging API Programming Guide
Reference
IOpcSignatureCustomObjectEnumerator
IOpcSignatureCustomObjectSet
IOpcSignatureReference
IOpcSignatureReferenceSet
Core Packaging Interfaces
Packaging Interfaces
Packaging API Reference
Packaging API Samples

 

 

Community Additions

ADD
Show: