Skip to content

Latest commit

 

History

History
187 lines (119 loc) · 6.77 KB

nf-msopc-iopcsignaturepartreferenceset-create.md

File metadata and controls

187 lines (119 loc) · 6.77 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:msopc.IOpcSignaturePartReferenceSet.Create
IOpcSignaturePartReferenceSet::Create (msopc.h)
Creates an IOpcSignaturePartReference interface pointer that represents a reference to a part to be signed, and adds the new interface to the set.
Create
Create method [Open Packaging Conventions]
Create method [Open Packaging Conventions]
IOpcSignaturePartReferenceSet interface
IOpcSignaturePartReferenceSet interface [Open Packaging Conventions]
Create method
IOpcSignaturePartReferenceSet.Create
IOpcSignaturePartReferenceSet::Create
msopc/IOpcSignaturePartReferenceSet::Create
opc.iopcsignaturepartreferenceset_create
opc\iopcsignaturepartreferenceset_create.htm
OPC
63162b37-0262-4d92-a14f-726fe4c87cc1
12/05/2018
Create, Create method [Open Packaging Conventions], Create method [Open Packaging Conventions],IOpcSignaturePartReferenceSet interface, IOpcSignaturePartReferenceSet interface [Open Packaging Conventions],Create method, IOpcSignaturePartReferenceSet.Create, IOpcSignaturePartReferenceSet::Create, msopc/IOpcSignaturePartReferenceSet::Create, opc.iopcsignaturepartreferenceset_create
msopc.h
Windows
Windows 7 [desktop apps only]
Windows Server 2008 R2 [desktop apps only]
OpcDigitalSignature.idl
Windows
19H1
IOpcSignaturePartReferenceSet::Create
msopc/IOpcSignaturePartReferenceSet::Create
c++
APIRef
kbSyntax
COM
msopc.h
IOpcSignaturePartReferenceSet.Create

IOpcSignaturePartReferenceSet::Create

-description

Creates an IOpcSignaturePartReference interface pointer that represents a reference to a part to be signed, and adds the new interface to the set.

-parameters

-param partUri [in]

An IOpcPartUri that represents the part name of the part to be referenced.

-param digestMethod [in]

The digest method to be used for part content of the part to be referenced. To use the default digest method, pass NULL to this parameter.

Important  The default digest method must be set by calling the IOpcSigningOptions::SetDefaultDigestMethod method before IOpcDigitalSignatureManager::Sign is called.

 

-param transformMethod [in]

The canonicalization method used for part content of the part to be referenced.

-param partReference [out, retval]

A new IOpcSignaturePartReference interface pointer that represents the reference to the part to be signed.

This parameter can be NULL if a pointer to the new interface is not needed.

-returns

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_INVALIDARG
The value passed in the transformMethod parameter is not a valid OPC_CANONICALIZATION_METHOD enumeration value.
E_POINTER
The partUri parameter is NULL.

-remarks

Only parts that can be represented by the IOpcPart interface can be referenced by an IOpcSignaturePartReference interface pointer. Relationships parts are referenced for signing by a pointer to the IOpcSignatureRelationshipReference interface. To create an IOpcSignatureRelationshipReference interface pointer, call the IOpcSignatureRelationshipReferenceSet::Create method.

When an IOpcSignaturePartReference interface pointer is created and added to the set, the reference it represents is saved when the package is saved.

Thread Safety

Packaging objects are not thread-safe.

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

-see-also

Core Packaging Interfaces

Getting Started with the Packaging API

IOpcDigitalSignatureManager

IOpcSignaturePartReferenceSet

IOpcSignatureRelationshipReferenceSet

IOpcSigningOptions

OPC_CANONICALIZATION_METHOD

Overviews

Packaging API Programming Guide

Packaging API Reference

Packaging API Samples

Packaging Digital Signature Interfaces

Packaging Interfaces

Reference