Freigeben über


IOpcRelationship::GetSourceUri-Methode (msopc.h)

Ruft den URI der Beziehungsquelle ab.

Syntax

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

Parameter

[out, retval] sourceUri

Ein Zeiger auf die IOpcUri-Schnittstelle des OPC-URI-Objekts, das den URI der Beziehungsquelle 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 BESCHREIBUNG
S_OK
Die Methode wurde erfolgreich ausgeführt.
E_POINTER
Der sourceUri-Parameter ist NULL.

Hinweise

Wenn die Quelle einer Beziehung das Paket selbst ist, stellt der URI in sourceUri den Paketstamm "/" dar.

Wenn das Beziehungsziel ein Teil ist, bilden Sie den Teilenamen, indem Sie die IOpcUri::CombinePartUri-Methode aus dem IOpcUri-Schnittstellenzeiger aufrufen, der in sourceUri empfangen wurde. Verwenden Sie den relativen URI im targetUri-Parameter der GetTargetUri-Methode als Eingabeparameter des IOpcUri::CombinePartUri-Aufrufs . Ein Beispiel finden Sie unter Auflösen eines Teilenamens aus einem Ziel-URI.

Weitere Informationen zu Beziehungen finden Sie unter Open Packaging Conventions Fundamentals und ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie im Erste Schritte mit der Verpackungs-API.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile msopc.h

Weitere Informationen

ECMA-376 OpenXML

Externe Ressourcen

Erste Schritte mit der Verpackungs-API

IOpcRelationship

Grundlagen offener Verpackungskonventionen

Übersichten

Verpackungs-API-Referenz

Beispiele für die Paket-API

Referenz

Übersicht über Beziehungen

Auflösen eines Teilenamens aus einem Ziel-URI