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

Article
02/29/2024

Obtient l’URI de la source de relation.

Syntaxe

HRESULT GetSourceUri(
  [out, retval] IOpcUri **sourceUri
);

Paramètres

[out, retval] sourceUri

Pointeur vers l’interface IOpcUri de l’objet OPC URI qui représente l’URI de la source de relation.

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 sourceUri est NULL.

Remarques

Si la source d’une relation est le package lui-même, l’URI dans sourceUri représente la racine du package : « / ».

Si la cible de relation est une partie, formez le nom du composant en appelant la méthode IOpcUri ::CombinePartUri à partir du pointeur d’interface IOpcUri reçu dans sourceUri. Utilisez l’URI relatif reçu dans le paramètre targetUri de la méthode GetTargetUri 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