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

Artículo
08/25/2023

Forma el nombre del elemento al que hace referencia el URI relativo especificado. El URI relativo especificado de la parte se resuelve en el URI representado como el objeto URI de OPC actual.

Sintaxis

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

Parámetros

[in] relativeUri

Puntero a la interfaz IUri del URI relativo del elemento.

Para formar el objeto URI de parte que representa el nombre de la parte, este URI de entrada se resuelve en el URI representado como el objeto URI de OPC actual. Por lo tanto, el URI de entrada debe ser relativo al URI representado por el objeto URI de OPC actual.

Este URI puede incluir un componente de fragmento; sin embargo, el fragmento se omitirá y no se incluirá en el nombre del elemento que se va a formar. Un componente de fragmento va precedido de "#", como se describe en RFC 3986: Sintaxis genérica de URI.

[out, retval] combinedUri

Puntero a la interfaz IOpcPartUri del objeto URI de parte que representa el nombre de la parte.

El objeto URI de parte se forma mediante la resolución del URI relativo en relativeUri con respecto al URI representado por el objeto URI de OPC actual.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código o valor devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_FAIL	La función CoInternetCombineUrl devolvió un tamaño no válido.
E_POINTER	Al menos uno de los parámetros relativeUri y combinedUri es NULL.
E_UNEXPECTED	El tamaño del búfer requerido por la función CoInternetCombineUrl cambió inesperadamente.
OPC_E_NONCONFORMING_URI 0x80510001	El nombre del elemento no se ajusta a las reglas especificadas en los estándares de OPC .
OPC_E_RELATIVE_URI_REQUIRED 0x80510002	Un nombre de elemento no puede ser un URI absoluto. Un URI absoluto comienza con un componente de esquema seguido de ":", como se describe en RFC 3986: Sintaxis genérica de URI.
Error de función CoInternetCombineUrl	Código de error HRESULT de la función CoInternetCombineUrl .
Error de función CreateUri	Código de error HRESULT de la función CreateUri .
Error de WinINet	Código de error HRESULT de una API de WinINet .

Comentarios

Entrada y salida de ejemplo:

IUri relativo de entrada	IOpcUri actual	IOpcPartUri formado
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

Para obtener información sobre cómo usar este método para ayudar a resolver un nombre de elemento, vea Resolver un nombre de elemento desde un URI de destino.

Compatibilidad con versiones anteriores de Windows

El comportamiento y el rendimiento de este método son los mismos en todas las versiones de Windows compatibles. Para obtener más información, consulte Introducción con packaging API y Platform Update para Windows Vista.

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para obtener más información, consulte el Introducción con packaging API.

Requisitos


Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	msopc.h