IOpcSigningOptions::GetCertificateSet method (msopc.h)

Gets an IOpcCertificateSet interface pointer.

Syntax

HRESULT GetCertificateSet(
  [out, retval] IOpcCertificateSet **certificateSet
);

Parameters

[out, retval] certificateSet

An IOpcCertificateSet interface pointer.

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 certificateSet parameter is NULL.

Remarks

This method gets a set that provides methods enabling the addition and removal of certificates from a certificate chain that will be associated with the signature when it is generated.

Do not include the certificate use to generate the signature in this set. This certificate, the signer certificate, is required for signature generation. To generate the signature, call the IOpcDigitalSignatureManager::Sign method with the certificate parameter value set to a pointer to the signer certificate.

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

Getting Started with the Packaging API

IOpcDigitalSignatureManager

IOpcSigningOptions

Overviews

Packaging API Programming Guide

Packaging API Reference

Packaging API Samples

Packaging Digital Signature Interfaces

Packaging Interfaces

Reference