Méthode IOpcPart ::GetRelationshipSet (msopc.h)

Article
08/25/2023

Obtient un objet d’ensemble de relations qui représente la partie Relations qui stocke les relations dont le composant est la source.

Syntaxe

HRESULT GetRelationshipSet(
  [out, retval] IOpcRelationshipSet **relationshipSet
);

Paramètres

[out, retval] relationshipSet

Pointeur vers un objet d’ensemble de relations qui représente la partie Relations qui stocke toutes les relations dont le composant est la source.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
E_POINTER	Le paramètre relationshipSet est NULL.
Erreur de consommation de package	Un code d’erreur HRESULT du groupe d’erreurs de consommation de package.
Erreur d’URI de composant	Code d’erreur HRESULT du groupe d’erreurs d’URI de composant.

Remarques

La façon définitive de trouver une partie d’intérêt consiste à utiliser un type de relation pour trouver la relation qui a la partie d’intérêt comme cible. L’URI de la cible peut ensuite être résolu en nom de composant utilisé pour accéder au composant.

Pour plus d’informations sur l’utilisation du type de relation pour rechercher une relation, puis une partie d’intérêt, consultez IOpcRelationshipSet et IOpcRelationship.

Pour plus d’informations sur les parties et les relations, consultez Principes de base des conventions d’open packaging et ECMA-376 OpenXML, 1ère édition, partie 2 : Open Packaging Conventions (OPC).

Cohérence de thread

Les objets d’empaquetage ne sont pas thread-safe.

Pour plus d’informations, consultez la Prise en main avec l’API d’empaquetage.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	msopc.h