IOpcRelationship::GetSourceUri-Methode (msopc.h)

Ruft den URI der Beziehungsquelle ab.

Syntax

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

Die 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ögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Rückgabecode Description
S_OK
Die Methode war erfolgreich.
E_POINTER
Der sourceUri-Parameter ist NULL.

Bemerkungen

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

Wenn es sich bei dem Beziehungsziel um einen Teil handelt, bilden Sie den Teilnamen, indem Sie die IOpcUri::CombinePartUri-Methode aus dem in sourceUri empfangenen IOpcUri-Schnittstellenzeiger aufrufen. Verwenden Sie den relativen URI, der im TargetUri-Parameter der GetTargetUri-Methode empfangen wurde, 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 and the ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).

Threadsicherheit

Das Verpacken von Objekten ist nicht threadsicher.

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

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 7 [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Fenster
Header msopc.h

Siehe auch

ECMA-376 OpenXML

Externe Ressourcen

Erste Schritte mit der Verpackungs-API

IOpcRelationship

Grundlagen der Open Packaging-Konventionen

Übersichten

Api-Referenz zum Packen

Packen von API-Beispielen

Referenz

Übersicht über Beziehungen

Auflösen eines Teilnamens aus einem Ziel-URI