Méthode IOpcUri ::GetRelationshipsPartUri (msopc.h)

Article
11/11/2023

Obtient le nom du composant Relations qui stocke les relations dont l’URI source est représenté par l’objet URI OPC actuel.

Syntaxe

HRESULT GetRelationshipsPartUri(
  [out, retval] IOpcPartUri **relationshipPartUri
);

Paramètres

[out, retval] relationshipPartUri

Pointeur vers l’interface IOpcPartUri de l’objet URI de composant qui représente le nom de la partie Relations. L’URI source des relations stockées dans ce composant Relations est représenté par l’objet URI OPC actuel.

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 relationshipPartUri est NULL.
OPC_E_NONCONFORMING_URI 0x80510001	L’IOpcUri actuel représente une partie Relations et ne peut pas être la source d’aucune relation.
Erreur de fonction CreateUri	Code d’erreur HRESULT de la fonction CreateUri .
Erreur WinINet	Code d’erreur HRESULT d’une API WinINet .

Remarques

Le tableau suivant montre les URI de partie Relations pour certains URI OPC.

OPC URI	Nom du composant Relations	Valeur renvoyée
/mydoc/images/picture.jpg	/mydoc/images/_rels/picture.jpg.rels	S_OK
/	/_rels/.rels	S_OK
/mydoc/images/_rels/picture.jpg.rels	Indéfini	OPC_E_NONCONFORMING_URI

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 Packaging.

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 \| Applications UWP]
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 \| Applications UWP]
Plateforme cible	Windows
En-tête	msopc.h