IXpsSignature::GetCertificateEnumerator method

Gets a pointer to an IOpcCertificateEnumerator interface, which enumerates the package certificates that are attached to the signature.

Syntax

HRESULT GetCertificateEnumerator(
  [out, retval] IOpcCertificateEnumerator **certificateEnumerator
);

Parameters

  • certificateEnumerator [out, retval]
    A pointer to an IOpcCertificateEnumerator interface, which enumerates the certificates that are attached to the signature.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the table that follows. For return values that are not listed in this table, see XPS Digital Signature API Errors and XPS Document Errors.

Return code Description
S_OK

The method succeeded.

E_UNEXPECTED

The interface is not connected to the signature manager.

 

Remarks

The IOpcCertificateEnumerator interface returned in certificateEnumerator can be empty; however the XML Paper Specification requires that at least the signing certificate be included in the XPS package. Package producers may include additional certificates as well. For example, the entire certificate trust chain could be included in the XPS package.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Xpsdigitalsignature.h

IDL

XpsDigitalSignature.idl

See also

IXpsSignature

IOpcCertificateEnumerator

IOpcDigitalSignature

IXpsSignatureManager

XPS Digital Signature API Errors

XPS Document Errors

XML Paper Specification