IOpcPartUri::GetSourceUri-Methode (msopc.h)

Artikel
03/04/2024

Ruft den Quell-URI der Beziehungen ab, die in einem Beziehungsteil gespeichert sind. Das aktuelle Part-URI-Objekt stellt den Teilenamen dieses Relationships-Teils dar.

Syntax

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

Parameter

[out, retval] sourceUri

Ein Zeiger auf die IOpcUri-Schnittstelle des OPC-URI-Objekts, der den URI der Quelle der im Beziehungsteil gespeicherten Beziehungen darstellt.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode/-wert	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	Der sourceUri-Parameter ist NULL.
OPC_E_RELATIONSHIP_URI_REQUIRED 0x80510003	Der Teilename eines Beziehungsteils ist erforderlich, aber der Name des Teils ist nicht der eines Beziehungsteils. Weitere Informationen zu den Teilenamen von Beziehungsteilen finden Sie unter OPC.
Fehler bei der CreateUri-Funktion	Ein HRESULT-Fehlercode aus der CreateUri-Funktion .
WinINet-Fehler	Ein HRESULT-Fehlercode aus einer WinINet-API .

Hinweise

Wenn das aktuelle Part-URI-Objekt den Teilenamen des Relationships-Teils darstellt, in dem Paketbeziehungen ("/_rels/.rels") gespeichert werden, stellt das in sourceUri zurückgegebene OPC-URI-Objekt den Paketstamm ("/") dar.

Wenn das aktuelle Part-URI-Objekt nicht der Teilename eines Relationships-Teils ist, schlägt diese Methode mit dem OPC_E_RELATIONSHIP_URI_REQUIRED Fehler fehl. Die Syntax für Beziehungsteilnamen wird in OPC angegeben.

In der folgenden Tabelle sind mögliche aktuelle Teil-URIs und der Quell-URI aufgeführt, der von dieser Methode zurückgegeben wird.

Aktueller Part-URI	Beschreibung des aktuellen Part-URI	Quell-URI	Beschreibung des Quell-URI	Rückgabewert
/mydoc/_rels/picture.jpg.rels	Der Teilename eines Beziehungsteils	/mydoc/picture.jpg	Der Teilename des Teils, der die Quelle der Beziehungen ist, die im Beziehungsteil gespeichert sind, der durch das aktuelle Part-URI-Objekt dargestellt wird.	S_OK
/_rels/.rels	Der Teilename eines Beziehungsteils	/	Der Paketstamm; Die Quelle der Beziehungen, die im Beziehungsteil gespeichert sind, der durch das aktuelle Part-URI-Objekt dargestellt wird	S_OK
/mydoc/image/chart1.jpg	Der Teilename eines Teils, das kein Beziehungsteil ist	Nicht definiert	Nicht definiert	OPC_E_RELATIONSHIP_URI_REQUIRED
/_rels/a.jpg	Der Teilename eines Teils, das kein Beziehungsteil ist	Nicht definiert	Nicht definiert	OPC_E_RELATIONSHIP_URI_REQUIRED

Unterstützung für frühere Windows-Versionen

Das Verhalten und die Leistung dieser Methode ist in allen unterstützten Windows-Versionen identisch. Weitere Informationen finden Sie unter Erste Schritte mit der Paketerstellungs-API und Plattformupdate für Windows Vista.

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie in der Erste Schritte mit der Paketerstellungs-API.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msopc.h