Méthode IOpcFactory ::CreatePartUri (msopc.h)

Article
08/25/2023

Crée un objet URI de composant qui représente un nom de composant.

Syntaxe

HRESULT CreatePartUri(
  [in]          LPCWSTR     pwzUri,
  [out, retval] IOpcPartUri **partUri
);

Paramètres

[in] pwzUri

URI qui représente l’emplacement d’une partie par rapport à la racine du package qui le contient.

[out, retval] partUri

Pointeur vers l’interface IOpcPartUri de l’objet URI de composant. Cet objet représente le nom de composant dérivé de l’URI passé dans pwzUri.

Les noms de parties doivent être conformes à la syntaxe spécifiée dans l’opc.

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	Au moins un des paramètres pwzUri et partUri est NULL.
OPC_E_NONCONFORMING_URI 0x80510001	Un nom de composant ne peut pas être la chaîne vide « ».
OPC_E_NONCONFORMING_URI 0x80510001	Un nom de composant ne peut pas être un « / ».
OPC_E_NONCONFORMING_URI 0x80510001	Un nom de composant ne peut pas commencer par « / / ».
OPC_E_NONCONFORMING_URI 0x80510001	Un nom de composant ne peut pas se terminer par un « / ».
OPC_E_NONCONFORMING_URI 0x80510001	Un nom de composant ne peut pas se terminer par un « . ».
OPC_E_NONCONFORMING_URI 0x80510001	Un nom de composant ne peut pas avoir de segments qui se terminent par un « . ».
OPC_E_NONCONFORMING_URI 0x80510001	Un nom de composant ne peut pas avoir de composant fragment. Un composant de fragment est précédé d’un caractère « # », comme décrit dans RFC 3986 : Syntaxe générique de l’URI.
OPC_E_NONCONFORMING_URI 0x80510001	Un nom de composant ne peut pas être le nom d’un composant Relations qui indique un autre composant Relations comme source des relations qu’il contient.
OPC_E_RELATIVE_URI_REQUIRED 0x80510002	Un nom de composant 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 CreateUri	Code d’erreur HRESULT de la fonction CreateUri .
Erreur WinINet	Code d’erreur HRESULT d’une API WinINet .

Remarques

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