Metodo IOpcRelationship::GetTargetUri (msopc.h)

Articolo
10/26/2023

Ottiene l'URI della destinazione della relazione.

Sintassi

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

Parametri

[out, retval] targetUri

Puntatore all'interfaccia IUri dell'URI che rappresenta l'URI della destinazione della relazione.

Se la destinazione della relazione è interna, la destinazione è una parte e l'URI della destinazione è relativo all'URI della parte di origine.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro targetUri è NULL.

Commenti

Il modo definitivo per trovare una parte di interesse consiste nell'usare un tipo di relazione.

L'individuazione di una parte di interesse richiede diversi passaggi. Per informazioni dettagliate sulla ricerca di una parte, vedere Cenni preliminari sulle parti e Ricerca della parte delle proprietà di base.

Per determinare se la destinazione della relazione è interna o esterna, chiamare il metodo GetTargetUri .

Se la destinazione della relazione è interna, la destinazione è una parte.

Se la destinazione della relazione è una parte, l'URI in targetUri è relativo all'URI dell'origine della relazione.

Se la destinazione della relazione è una parte, formare il nome della parte chiamando il metodo IOpcUri::CombinePartUri dal puntatore all'interfaccia IOpcUri ricevuto nel parametro sourceUri del metodo GetSourceUri . Usare l'URI relativo ricevuto in targetUri come parametro di input della chiamata IOpcUri::CombinePartUri . Per un esempio, vedere Risoluzione di un nome parte da un URI di destinazione.

Per altre informazioni sulle relazioni, vedere Open Packaging Conventions Fundamentals e ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).For more information about relationships, see the Open Packaging Conventions fundamentals and the ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).

Thread safety

I pacchetti degli oggetti non sono thread-safe.

Per altre informazioni, vedere l'Introduzione con l'API per la creazione di pacchetti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msopc.h