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

Artigo
03/05/2024

Obtém o nome da parte Relações que armazena relações que têm o URI de origem representado pelo objeto URI OPC atual.

Sintaxe

HRESULT GetRelationshipsPartUri(
  [out, retval] IOpcPartUri **relationshipPartUri
);

Parâmetros

[out, retval] relationshipPartUri

Um ponteiro para a interface IOpcPartUri do objeto URI de parte que representa o nome da parte Relações. O URI de origem das relações armazenadas nesta parte Relações é 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_POINTER	O parâmetro relationshipPartUri é NULL.
OPC_E_NONCONFORMING_URI 0x80510001	O IOpcUri atual representa uma parte Relações e não pode ser a origem de nenhuma relação.
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

A tabela a seguir mostra URIs da parte Relações para alguns URIs OPC.

OPC URI	Nome da Parte de Relações	Valor Retornado
/mydoc/images/picture.jpg	/mydoc/images/_rels/picture.jpg.rels	S_OK
/	/_rels/.rels	S_OK
/mydoc/images/_rels/picture.jpg.rels	Indefinido	OPC_E_NONCONFORMING_URI

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

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