Méthode IOpcRelationship ::GetTargetUri (msopc.h)
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 |
|
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 |
Voir aussi
Ressources externes
Prise en main avec l’API d’empaquetage
Principes de base d’Open Packaging Conventions
Vues d'ensemble
Informations de référence sur l’API d’empaque
Référence