Condividi tramite


Metodo IOpcRelationship::GetSourceUri (msopc.h)

Ottiene l'URI dell'origine della relazione.

Sintassi

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

Parametri

[out, retval] sourceUri

Puntatore all'interfaccia IOpcUri dell'oggetto URI OPC che rappresenta l'URI dell'origine della relazione.

Valore restituito

Il metodo restituisce un 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 sourceUri è NULL.

Commenti

Se l'origine di una relazione è il pacchetto stesso, l'URI nell'URI di origine rappresenta la radice del pacchetto: "/".

Se la destinazione della relazione è una parte, formare il nome della parte chiamando il metodo IOpcUri::CombinePartUri dal puntatore dell'interfaccia IOpcUri ricevuto in sourceUri. Usare l'URI relativo ricevuto nel parametro targetUri del metodo GetTargetUri 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).

Thread safety

Gli oggetti di creazione dei pacchetti non sono thread-safe.

Per altre informazioni, vedere l'Introduzione con l'API Creazione 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

Vedi anche

ECMA-376 OpenXML

Risorse esterne

Introduzione con l'API Creazione pacchetti

IOpcRelationship

Aprire convenzioni di creazione pacchetti

Cenni preliminari

Informazioni di riferimento sulle API per la creazione di pacchetti

Esempi di API di creazione di pacchetti

Riferimento

Panoramica sulle relazioni

Risoluzione di un nome parte da un URI di destinazione