Méthode IOpcRelationship ::GetTargetUri (msopc.h)

Article
02/29/2024

Obtient l’URI de la cible de relation.

Syntaxe

HRESULT GetTargetUri(
  [out, retval] IUri **targetUri
);

Paramètres

[out, retval] targetUri

Pointeur vers l’interface IUri de l’URI qui représente l’URI de la cible de la relation.

Si la cible de relation est interne, la cible est une partie et l’URI de la cible est relatif à l’URI du composant 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 targetUri est NULL.

Remarques

La façon définitive de trouver une partie de l’intérêt consiste à utiliser un type de relation.

La recherche d’une partie d’intérêt nécessite plusieurs étapes. Pour plus d’informations sur la recherche d’un composant, consultez Vue d’ensemble des composants et Recherche du composant Propriétés principales.

Pour déterminer si la cible de la relation est interne ou externe, appelez la méthode GetTargetUri .

Si la cible de relation est interne, la cible en fait partie.

Si la cible de relation fait partie, l’URI dans targetUri est relatif à l’URI de la source de relation.

Si la cible de relation est une partie, formez le nom de la partie en appelant la méthode IOpcUri ::CombinePartUri à partir du pointeur d’interface IOpcUri reçu dans le paramètre sourceUri de la méthode GetSourceUri . Utilisez l’URI relatif reçu dans targetUri comme paramètre d’entrée de l’appel IOpcUri ::CombinePartUri . Pour obtenir un exemple, consultez Résolution d’un nom de partie à partir d’un URI cible.

Pour plus d’informations sur les relations, consultez Open Packaging Conventions Fundamentals et ECMA-376 OpenXML, 1st Edition, Part 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 Packaging.

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