IOpcRelationship::GetRelationshipType method

Gets the relationship type.

Syntax


HRESULT GetRelationshipType(
  [out, retval] LPCWSTR *relationshipType
);

Parameters

relationshipType [out, retval]

Receives the relationship type, which is the qualified name of the relationship, as defined by the package format designer or the OPC.

For more information about relationship types see Remarks.

Return value

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

Return codeDescription
S_OK

The method succeeded.

E_POINTER

The relationshipType parameter is NULL.

 

Remarks

This method allocates memory used by the string returned in relationshipType. If the method succeeds, call the CoTaskMemFree function to free the memory.

The definitive way to find a part of interest is by using a relationship type.

Finding a part of interest requires several steps. For detailed information about finding a part, see Finding the Core Properties Part.

For more information about relationships, relationship types and a list of relationship types defined by the OPC, see the Open Packaging Conventions Fundamentals and the OPC.

Thread Safety

Packaging objects are not thread-safe.

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

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Msopc.h

IDL

Opcobjectmodel.idl

See also

IOpcRelationship
Overviews
Finding the Core Properties Part
Getting Started with the Packaging API
Open Packaging Conventions Fundamentals
Relationships Overview
Reference
IOpcRelationshipSet::GetEnumeratorForType
Packaging API Reference
Packaging API Samples
External Resources
ECMA-376 OpenXML

 

 

Community Additions

ADD
Show: