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

Article
10/26/2023

Forme le nom de la partie référencée par l’URI relatif spécifié. L’URI relatif spécifié de la partie est résolu par rapport à l’URI représenté en tant qu’objet URI OPC actuel.

Syntaxe

HRESULT CombinePartUri(
  [in]          IUri        *relativeUri,
  [out, retval] IOpcPartUri **combinedUri
);

Paramètres

[in] relativeUri

Pointeur vers l’interface IUri de l’URI relatif du composant.

Pour former l’objet URI de composant qui représente le nom de la partie, cet URI d’entrée est résolu par rapport à l’URI représenté en tant qu’objet URI OPC actuel. Par conséquent, l’URI d’entrée doit être relatif à l’URI représenté par l’objet URI OPC actuel.

Cet URI peut inclure un composant fragment ; toutefois, le fragment sera ignoré et ne sera pas inclus dans le nom de la partie à former. Un composant fragment est précédé d’un « # », comme décrit dans RFC 3986 : Syntaxe générique d’URI.

[out, retval] combinedUri

Pointeur vers l’interface IOpcPartUri de l’objet URI de composant qui représente le nom de la partie.

L’objet URI de partie est formé en résolvant l’URI relatif dans relativeUri par rapport à l’URI 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_FAIL	La fonction CoInternetCombineUrl a retourné une taille non valide.
E_POINTER	Au moins l’un des paramètres relativeUri et combinéUri a la valeur NULL.
E_UNEXPECTED	La taille de la mémoire tampon requise par la fonction CoInternetCombineUrl a changé de manière inattendue.
OPC_E_NONCONFORMING_URI 0x80510001	Le nom de la partie n’est pas conforme aux règles spécifiées dans les normes OPC .
OPC_E_RELATIVE_URI_REQUIRED 0x80510002	Un nom de pièce ne peut pas être un URI absolu. Un URI absolu commence par un composant de schéma suivi d’un « : », comme décrit dans RFC 3986 : Syntaxe générique de l’URI.
Erreur de fonction CoInternetCombineUrl	Code d’erreur HRESULT de la fonction CoInternetCombineUrl .
Erreur de fonction CreateUri	Code d’erreur HRESULT de la fonction CreateUri .
Erreur WinINet	Code d’erreur HRESULT d’une API WinINet .

Remarques

Exemple d’entrée et de sortie :

IUri relatif d’entrée	IOpcUri actuel	IOpcPartUri formé
picture.jpg	/mydoc/markup/page.xml	/mydoc/markup/picture.jpg
.. /picture.jpg	/mydoc/markup/page.xml	/mydoc/picture.jpg
.. /.. /images/picture.jpg	/mydoc/page.xml	/images/picture.jpg

Pour plus d’informations sur l’utilisation de cette méthode pour résoudre un nom de partie, consultez Résolution d’un nom de composant à partir d’un URI cible.

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


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