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

Artigo
08/25/2023

Forma o nome da parte referenciada pelo URI relativo especificado. O URI relativo especificado da parte é resolvido em relação ao URI representado como o objeto URI OPC atual.

Sintaxe

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

Parâmetros

[in] relativeUri

Um ponteiro para a interface IUri do URI relativo da parte.

Para formar o objeto URI da parte que representa o nome da parte, esse URI de entrada é resolvido em relação ao URI representado como o objeto URI OPC atual. Portanto, o URI de entrada deve ser relativo ao URI representado pelo objeto URI OPC atual.

Esse URI pode incluir um componente de fragmento; no entanto, o fragmento será ignorado e não será incluído no nome da parte a ser formado. Um componente de fragmento é precedido por um '#', conforme descrito em RFC 3986: Sintaxe genérica de URI.

[out, retval] combinedUri

Um ponteiro para a interface IOpcPartUri do objeto URI da parte que representa o nome da parte.

O objeto URI da parte é formado resolvendo o URI relativo em relativeUri em relação ao URI representado pelo objeto URI OPC atual.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor/código retornado	Descrição
S_OK	O método foi bem-sucedido.
E_FAIL	A função CoInternetCombineUrl retornou um tamanho inválido.
E_POINTER	Pelo menos um dos parâmetros relativeUri e combinedUri é NULL.
E_UNEXPECTED	O tamanho do buffer exigido pela função CoInternetCombineUrl foi alterado inesperadamente.
OPC_E_NONCONFORMING_URI 0x80510001	O nome da parte não está em conformidade com as regras especificadas nos padrões OPC .
OPC_E_RELATIVE_URI_REQUIRED 0x80510002	Um nome de parte não pode ser um URI absoluto. Um URI absoluto começa com um componente de esquema seguido por um ":", conforme descrito em RFC 3986: Sintaxe genérica de URI.
Erro da função CoInternetCombineUrl	Um código de erro HRESULT da função CoInternetCombineUrl .
Erro de função CreateUri	Um código de erro HRESULT da função CreateUri .
Erro winINet	Um código de erro HRESULT de uma API WinINet .

Comentários

Exemplo de entrada e saída:

IUri relativo de entrada	IOpcUri atual	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 obter informações sobre como usar esse método para ajudar a resolve um nome de parte, consulte Resolvendo um nome de parte de um URI de destino.

Suporte em versões anteriores do Windows

O comportamento e o desempenho desse método são os mesmos em todas as versões com suporte do Windows. Para obter mais informações, consulte Introdução com a API de Empacotamento e Atualização de Plataforma para Windows Vista.

Acesso thread-safe

Os objetos de empacotamento não são thread-safe.

Para obter mais informações, consulte o Introdução com a API de Empacotamento.

Requisitos


Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	msopc.h