IOpcRelationshipSelectorSet::Create method (msopc.h)

Article
02/22/2024

Creates an IOpcRelationshipSelector interface pointer to represent how a subset of relationships are selected to be signed, and adds the new pointer to the set.

Syntax

HRESULT Create(
  [in]          OPC_RELATIONSHIP_SELECTOR selector,
  [in]          LPCWSTR                   selectionCriterion,
  [out, retval] IOpcRelationshipSelector  **relationshipSelector
);

Parameters

[in] selector

A value that describes how to interpret the string that is passed in selectionCriterion.

[in] selectionCriterion

A string that is interpreted to yield a criterion.

[out, retval] relationshipSelector

A new IOpcRelationshipSelector interface pointer that represents how relationships are selected from a Relationships part.

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

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

Remarks

Use the methods of the IOpcRelationshipSelector interface pointers in the set to select relationships for signing.

When an IOpcRelationshipSelector interface pointer is created and added to the set, the criterion it provides access to 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.

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