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

Forma um URI relativo para uma parte especificada, em relação ao URI representado pelo objeto OPC URI atual.

Sintaxe

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

[in] targetPartUri

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

[out, retval] relativeUri

Um ponteiro para a interface IUri do URI da parte, em relação ao objeto OPC URI atual.

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

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	Pelo menos um dos parâmetros targetPartUri e relativePartUri é NULL.
Erro de função CreateUri	Um código de erro HRESULT da função CreateUri .
Erro de WinINet	Um código de erro HRESULT de uma API WinINet .

Entrada e saída de exemplo:

IOpcPartUri de entrada representa	O IOpcUri atual representa	IUri relativo retornado representa
/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

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

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

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

Requisito	Valor
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 Platform Update para Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	msopc.h