IOpcPartUri ::GetSourceUri, méthode (msopc.h)

Article
08/25/2023

Obtient l’URI source des relations stockées dans un composant Relations. L’objet URI de composant actuel représente le nom de la partie Relations.

Syntaxe

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

Paramètres

[out, retval] sourceUri

Pointeur vers l’interface IOpcUri de l’objet URI OPC qui représente l’URI de la source des relations stockées dans la partie Relations.

Valeur retournée

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

Code/valeur de retour	Description
S_OK	S_OK
E_POINTER	Le paramètre sourceUri est NULL.
OPC_E_RELATIONSHIP_URI_REQUIRED 0x80510003	Le nom de composant d’un composant Relations est obligatoire, mais le nom de composant n’est pas celui d’un composant Relations. Pour plus d’informations sur les noms de parties de relations, consultez OPC.
Erreur de fonction CreateUri	Code d’erreur HRESULT de la fonction CreateUri .
Erreur WinINet	Code d’erreur HRESULT d’une API WinINet .

Remarques

Si l’objet URI de composant actuel représente le nom de la partie Relations qui stocke les relations de package (« /_rels/.rels »), l’objet URI OPC retourné dans sourceUri représente la racine du package (« / »).

Si l’objet URI de composant actuel n’est pas le nom de partie d’un composant Relations, cette méthode échoue avec l’erreur OPC_E_RELATIONSHIP_URI_REQUIRED . La syntaxe des noms de parties de relation est spécifiée dans l’OPC.

Le tableau suivant présente les URI de la partie actuelle possibles et l’URI source qui serait retourné par cette méthode.

URI de composant actuel	Description de l’URI du composant actuel	URI source	Description de l’URI source	Valeur renvoyée
/mydoc/_rels/picture.jpg.rels	Nom de composant d’un composant Relations	/mydoc/picture.jpg	Nom de la partie qui est la source des relations stockées dans la partie Relations représentée par l’objet URI de composant actuel	S_OK
/_rels/.rels	Nom de composant d’un composant Relations	/	Racine du package ; source des relations stockées dans la partie Relations représentée par l’objet URI de composant actuel	S_OK
/mydoc/image/chart1.jpg	Nom de composant d’un composant qui n’est pas un composant Relations	Indéfini	Indéfini	OPC_E_RELATIONSHIP_URI_REQUIRED
/_rels/a.jpg	Nom de composant d’un composant qui n’est pas un composant Relations	Indéfini	Indéfini	OPC_E_RELATIONSHIP_URI_REQUIRED

Prise en charge sur les versions précédentes de Windows

Le comportement et les performances de cette méthode sont les mêmes sur toutes les versions de Windows prises en charge. Pour plus d’informations, consultez Prise en main avec l’API d’empaquetage et Mise à jour de plateforme pour Windows Vista.

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, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	msopc.h