Método IOpcPartUri::GetSourceUri (msopc.h)

Artigo
03/05/2024

Obtém o URI de origem das relações armazenadas em uma parte Relações. O objeto URI da parte atual representa o nome da parte da parte Relações.

Sintaxe

HRESULT GetSourceUri(
  [out, retval] IOpcUri **sourceUri
);

Parâmetros

[out, retval] sourceUri

Um ponteiro para a interface IOpcUri do objeto URI OPC que representa o URI da origem das relações armazenadas na parte Relações.

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 sourceUri é NULL.
OPC_E_RELATIONSHIP_URI_REQUIRED 0x80510003	O nome da parte de uma parte Relações é necessário, mas o nome da parte não é o de uma parte Relações. Para obter mais informações sobre os nomes de parte das partes Relações, consulte o OPC.
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

Se o objeto URI da parte atual representar o nome da parte Relações que armazena relações de pacote ("/_rels/.rels"), o objeto URI OPC retornado em sourceUri representará a raiz do pacote ("/").

Se o objeto URI da parte atual não for o nome da parte de uma parte Relationships, esse método falhará com o erro OPC_E_RELATIONSHIP_URI_REQUIRED . A sintaxe para nomes de parte de relação é especificada no OPC.

A tabela a seguir mostra possíveis URIs de parte atual e o URI de origem que seriam retornados por esse método.

URI da Parte Atual	Descrição do URI da Parte Atual	URI de origem	Descrição do URI de origem	Valor Retornado
/mydoc/_rels/picture.jpg.rels	O nome da parte de uma parte Relações	/mydoc/picture.jpg	O nome da parte que é a origem das relações armazenadas na parte Relações representada pelo objeto URI da parte atual	S_OK
/_rels/.rels	O nome da parte de uma parte Relações	/	A raiz do pacote; a origem das relações armazenadas na parte Relações representada pelo objeto URI da parte atual	S_OK
/mydoc/image/chart1.jpg	O nome da parte de uma parte que não é uma parte Relações	Indefinido	Indefinido	OPC_E_RELATIONSHIP_URI_REQUIRED
/_rels/a.jpg	O nome da parte de uma parte que não é uma parte Relações	Indefinido	Indefinido	OPC_E_RELATIONSHIP_URI_REQUIRED

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 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msopc.h