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

Artigo
10/26/2023

Obtém o URI do destino da relação.

Sintaxe

HRESULT GetTargetUri(
  [out, retval] IUri **targetUri
);

Parâmetros

[out, retval] targetUri

Um ponteiro para a interface IUri do URI que representa o URI do destino da relação.

Se o destino da relação for interno, o destino será uma parte e o URI do destino será relativo ao URI da parte de origem.

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 targetUri é NULL.

Comentários

A maneira definitiva de encontrar uma parte de interesse é usando um tipo de relação.

Encontrar uma parte de interesse requer várias etapas. Para obter informações detalhadas sobre como encontrar uma parte, consulte Visão geral de partes e Localizando a parte propriedades principais.

Para determinar se o destino da relação é interno ou externo, chame o método GetTargetUri .

Se o destino da relação for interno, o destino será uma parte.

Se o destino da relação for uma parte, o URI em targetUri será relativo ao URI da origem da relação.

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 no parâmetro sourceUri do método GetSourceUri . Use o URI relativo recebido em targetUri 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