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

Artigo
03/05/2024

Obtém o URI da origem da relação.

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 da relação.

Retornar valor

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	O parâmetro sourceUri é NULL.

Comentários

Se a origem de uma relação for o próprio pacote, o URI em sourceUri representará a raiz do pacote: "/".

Se o destino da relação for uma parte, forme o nome da parte chamando o método IOpcUri::CombinePartUri do ponteiro da interface IOpcUri recebido em sourceUri. Use o URI relativo recebido no parâmetro targetUri do método GetTargetUri como o parâmetro de entrada da chamada IOpcUri::CombinePartUri . Para obter um exemplo, consulte Resolvendo um nome de parte de um URI de destino.

Para obter mais informações sobre relações, consulte Os Conceitos básicos das Convenções de Empacotamento Aberto e o OpenXML ECMA-376, 1ª Edição, Parte 2: Convenções de Empacotamento Aberto (OPC).

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