IOpcDigitalSignature::GetCustomReferenceEnumerator method (msopc.h)

Gets an enumerator of the IOpcSignatureReference interface pointers that represent references to application-specific XML elements that have been signed.

Syntax

HRESULT GetCustomReferenceEnumerator(
  [out, retval] IOpcSignatureReferenceEnumerator **customReferenceEnumerator
);

Parameters

[out, retval] customReferenceEnumerator

A pointer to an enumerator of IOpcSignatureReference interface pointers. An IOpcSignatureReference interface pointer represents a reference to an application-specific XML element that has been signed.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.
E_POINTER
The customReferenceEnumerator parameter is NULL.

Remarks

To access the signed XML Element by using an IOpcSignatureCustomObject interface pointer, call the IOpcSignatureCustomObjectEnumerator::GetCurrent method. To access the markup of the signed XML element, call the IOpcSignatureCustomObject::GetXml method.

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 only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header msopc.h

See also

Core Packaging Interfaces

Digital Signatures Overview

Getting Started with the Packaging API

IOpcDigitalSignature

IOpcSignatureCustomObjectEnumerator

IOpcSignatureReferenceEnumerator

IOpcSignatureReferenceSet

Overviews

Packaging API Programming Guide

Packaging API Reference

Packaging API Samples

Packaging Digital Signature Interfaces

Packaging Interfaces

Reference