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

Forme un URI relatif pour une partie spécifiée, par rapport à l’URI représenté par l’objet OPC URI actuel.

Syntaxe

HRESULT GetRelativeUri(
  [in]          IOpcPartUri *targetPartUri,
  [out, retval] IUri        **relativeUri
);

[in] targetPartUri

Pointeur vers l’interface IOpcPartUri de l’objet URI de composant qui représente le nom de partie à partir duquel l’URI relatif est formé.

[out, retval] relativeUri

Pointeur vers l’interface IUri de l’URI de la partie, par rapport à l’objet URI OPC actuel.

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	Au moins l’un des paramètres targetPartUri et relativePartUri est NULL.
Erreur de fonction CreateUri	Code d’erreur HRESULT de la fonction CreateUri .
Erreur WinINet	Code d’erreur HRESULT d’une API WinINet .

Exemple d’entrée et de sortie :

IOpcPartUri d’entrée représente	IOpcUri actuel représente	Représente les IUri relatifs retournés
/mydoc/markup/page.xml	/mydoc/markup/picture.jpg	picture.jpg
/mydoc/markup/page.xml	/mydoc/picture.jpg	.. /picture.jpg
/mydoc/markup/page.xml	/mydoc/images/pictures.jpg	.. /images/pictures.jpg

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.

Les objets d’empaquetage ne sont pas thread-safe.

Pour plus d’informations, consultez la Prise en main avec l’API Packaging.

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